開発者向けドキュメントは英語で公開されています。サイドバーは選択した言語に追従します。

サポート & 請求

クレジット、レート制限、エラーの仕組みとアップグレード方法。

クレジットと請求

  • ✅ HTTP 200 のみ課金：有料エンドポイントの成功リクエストごとに 1 クレジット。
  • ❌ 4xx / 5xx エラー：一切課金されません — 安全にリトライ可能。
  • ❌ レート制限（429）：課金されません。
  • ✅ 無料エンドポイント：/v1/verify、/v1/youtube/channel/resolve、/v1/youtube/channel/latest、GET /v1/youtube/asr/{task_id}（ポーリング）、全 /v1/library 読み取り。
  • 📦 ページネーション：ページごとに 1 クレジット（チャンネル動画、プレイリスト）。

プラン：無料 1,000 クレジット · Pro 10,000 クレジット/月 · 料金 を参照。

レート制限

各 API キーは 1 分あたり 200 リクエスト まで。すべてのレスポンスにレート制限ヘッダーが含まれます：

ヘッダー説明
X-RateLimit-Limit1 分あたりの許容総数（200）
X-RateLimit-Remaining現在のウィンドウで残っているリクエスト数
X-RateLimit-Resetウィンドウがリセットされる Unix タイムスタンプ

超過すると API は 429 と Retry-After ヘッダー（秒）を返します。

エラーコード

ステータス意味課金
200成功あり（有料エンドポイント）
400不正なリクエスト / パラメータ不足なし
401API キー無効または欠落なし
402クレジット切れなし
404動画 / チャンネル / 字幕が見つからないなし
429レート制限超過なし
500内部サーバーエラーなし

エラーレスポンスボディ

401 Unauthorized

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 Credits Exhausted

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 Not Found（字幕なし）

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 Rate Limited

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// レスポンスには次のヘッダーも含まれます：  Retry-After: 12

サポート