レート制限

各 API キーには、プランから導出される持続的な 秒間リクエスト数 の制限があります（Free 1 req/s → Max 60 req/s — 料金 を参照）。制限はトークンバケットで適用されます: 分間容量までの バーストは許可され、その後リクエストは持続レートに平滑化されます。

制限されたとき

{ "error": "rate_limited", "retry_after_ms": 850 }

• HTTP 429、error: "rate_limited"。
• retry_after_ms は再試行前に待つべき最小時間を示します。
• すべてのレスポンスの x-ratelimit-remaining ヘッダーは、その分に残っているリクエスト数を報告します。

同時実行数

秒間レートに加えて、処理中 のリクエスト数に上限があります。多数のリクエストを一度に発行すると、 次のような結果になることがあります:

• 409 request_in_progress — 同一の冪等リクエストがすでに実行中です。
• 503 too_many_concurrent_requests — 処理中の同時リクエストが多すぎます。バックオフして再試行してください。

制限への対処

• retry_after_ms を尊重してください。それ以外の場合はジッター付き指数バックオフを使用してください。
• プランのレートに合わせたクライアント側の同時実行上限を維持してください。
• 公式 SDK は 429/503 を自動的に再試行します。

ヒント

より高いレートが必要ですか? プランをアップグレードするか、Enterprise の制限について お問い合わせ ください。