LLMGenerator API ドキュメントへようこそ。本 API では、llms.txt の生成や管理をアプリケーションに直接組み込むためのプログラムからのアクセスを提供します。
ベース URL
すべての API エンドポイントは、次のベース URL を基準とした相対パスです。
https://api.llmgenerator.com/api/v1
認証（API キー）
LLMGenerator API では、API キーでリクエストを認証します。API キーは 設定 → API キー で作成・管理できます。
認証が必要なリクエストには、Authorization ヘッダーに API キーを Bearer トークンとして付与します。
Authorization: Bearer YOUR_API_KEY
API キーは厳重に管理してください。GitHub やクライアント側のコードなど、公開されうる場所に置かないでください。
生成方式
API では次の 2 つの生成方式をサポートします。
| メソッド | 説明 | クレジット消費 |
|---|
| Simple | ページのメタデータを用いた高速生成。迅速な結果向けです。 | 1x |
| Enhanced | タイトル・説明文を AI で改善した生成方式。 | 2x |
/generate エンドポイントの generationMethod パラメーターで方式を指定できます。無料プランでは simple のみ利用できます。
クレジット制度
API の利用状況はクレジットで集計されます。
- Simple 生成: 処理した URL あたりの基本クレジット
- Enhanced 生成: AI 処理のため 2 倍のクレジット係数
- フルテキスト: ページ全文を含める場合の追加クレジット
残高は /credits/balance エンドポイントで確認できます。
レート制限
API リクエストは契約プランに応じてレート制限されます。制限を超えると 429 Too Many Requests が返ります。レスポンスヘッダーに次のレート制限情報が含まれます。
X-RateLimit-Limit: 1 分あたりの最大リクエスト数X-RateLimit-Remaining: 現在のウィンドウで残りのリクエスト数X-RateLimit-Reset: ウィンドウがリセットされる時刻（UTC のエポック秒）
CORS 対応
公開ファイル用エンドポイント（/file/:siteId）は CORS に対応しており、ブラウザから直接呼び出せます。認証は不要です。
エラー
API は標準的な HTTP ステータスコードを使用します。
| コード | 説明 |
|---|
200 | 成功 |
201 | リソース作成済み |
400 | 不正なリクエスト（バリデーションエラー） |
401 | 未認証（API キーが無効または未指定） |
403 | 禁止（権限不足） |
404 | リソースが見つからない |
429 | レート制限超過 |
500 | サーバー内部エラー |
{
"message": "Validation error: URL is required"
}
Webhook
長時間かかる処理については、ジョブ完了時に通知を受け取る Webhook URL を設定できます。アカウントで Webhook を有効にするにはサポートへお問い合わせください。 
