GET STARTED

上限と 429

秒間リクエスト数と月間の上限、リクエストが拒否される順番、429 のときの再試行の目安をまとめています。

更新: 2026年10月12日

上限は二つあります。秒間のリクエスト数(rps) と 月間の件数 です。どちらもプランで決まります。数値の一覧は料金が正です。

拒否される順番

リクエストは、次の順に確認されます。

順条件ステータス課金
1キーが無効、または猶予が過ぎた401なし
2プランで使えない機能(例: Developer での /v1/batch)403なし
3月間の上限を超えた402なし
4秒間の上限を超えた429なし

月間の上限は、秒間の上限より先に確認されます。

確定待ち 月間の上限を超えたときの、製品としての扱い(停止・従量課金・案内など)は確定していません。現在の実装は 402 を返します。

秒間の上限(rps)

プランrps
Developer2
Starter5
Growth20
Business50
Enterprise個別に調整

1秒ごとの固定の窓で数えます。超えると 429 を返し、retry_after: 1(1秒後に再試行)を伝えます。

過負荷のとき

処理が追いつかないときは、待たせ続けず 429 を返します。Retry-After ヘッダーの値だけ待ってから再試行してください。

再試行のしかた

429 は、待てば成功する可能性があります。指数バックオフ(待ち時間を倍にする)と、少しのランダムな揺らぎ(ジッター)を組み合わせてください。コード付きの手順は再試行と429にあります。

この内容に誤りや不足があれば、お知らせください。