GET STARTED
上限と 429
秒間リクエスト数と月間の上限、リクエストが拒否される順番、429 のときの再試行の目安をまとめています。
更新: 2026年10月12日
上限は二つあります。秒間のリクエスト数(rps) と 月間の件数 です。どちらもプランで決まります。数値の一覧は料金が正です。
拒否される順番
リクエストは、次の順に確認されます。
| 順 | 条件 | ステータス | 課金 |
|---|---|---|---|
| 1 | キーが無効、または猶予が過ぎた | 401 | なし |
| 2 | プランで使えない機能(例: Developer での /v1/batch) | 403 | なし |
| 3 | 月間の上限を超えた | 402 | なし |
| 4 | 秒間の上限を超えた | 429 | なし |
月間の上限は、秒間の上限より先に確認されます。
確定待ち 月間の上限を超えたときの、製品としての扱い(停止・従量課金・案内など)は確定していません。現在の実装は 402 を返します。
秒間の上限(rps)
| プラン | rps |
|---|---|
| Developer | 2 |
| Starter | 5 |
| Growth | 20 |
| Business | 50 |
| Enterprise | 個別に調整 |
1秒ごとの固定の窓で数えます。超えると 429 を返し、retry_after: 1(1秒後に再試行)を伝えます。
過負荷のとき
処理が追いつかないときは、待たせ続けず 429 を返します。Retry-After ヘッダーの値だけ待ってから再試行してください。
再試行のしかた
429 は、待てば成功する可能性があります。指数バックオフ(待ち時間を倍にする)と、少しのランダムな揺らぎ(ジッター)を組み合わせてください。コード付きの手順は再試行と429にあります。
この内容に誤りや不足があれば、お知らせください。