Error 429 Too Many Requests
429が繰り返される場合、上流アカウントプールがレート制限中、クールダウン中、または利用可能なクォータを使い切っている可能性があります。まずサービス運営者にアカウント、ルート、モデルの切り替えを依頼し、次に最小リクエストでローカルの同時実行数、残高、再試行ループの問題を切り分けます。
概要
Error: exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>. AI API中継サービスで429が繰り返される場合、上流アカウントプールのレート制限、クールダウン、利用可能クォータの枯渇が主な原因です。まずサービス運営者にアカウント、ルート、モデルの切り替えを依頼してください。
429 Too Many Requestsエラーの意味
429 Too Many Requestsは、リクエストの基本形式は受け付けられたものの、クォータまたはレート上限に達しているため、現時点では処理を拒否されたことを示します。
AI API中継サービスでは、同じAPIキーを再試行する前に、サービス側の上流アカウントプールを確認してください。そのプールがクールダウン中または枯渇している場合、再試行を繰り返すと429がさらに増えます。
主な原因
- 中継サービスの上流アカウントプールがレート上限に達した、クールダウンに入った、または利用可能なクォータを失った。
- 現在のモデルルートに有効な課金枠がない、モデル固有の上限に達した、または利用可能な正常な上流アカウントがない。
- 別のアカウントプールや上流の公式APIに余裕があっても、中継サービス側が利用中のキーをレート制限している。
- Claude Code、Codex、Cursorなどのツールが失敗した呼び出しを再試行し、1回の失敗を短時間で多数のリクエストに増幅している。
- 長いコンテキスト、ストリーミングタスク、バッチ処理、コーディングエージェントのループが、想定より速くトークンを消費している。
AI API中継サービスで429を診断する方法
同じベースURL、APIキー、モデルを使用し、可能な限り小さいリクエストから確認します。このリクエストも429になる場合は、クォータ、課金、サービス側の上限、プロキシ側のスロットリングが原因である可能性が高くなります。
最小リクエストは成功してコーディングツールが失敗する場合は、エージェントの同時実行数を減らし、再試行ループがないか確認してください。コーディングエージェントは、ファイルの読み取り、ツール呼び出し、失敗からの復旧中に、多数の小さなリクエストを短時間で送ることがあります。
AI API中継サービスで429を解決する方法
- 再試行まで待ちます。レスポンスに
Retry-Afterヘッダーがある場合は、同じリクエストをすぐに送らず、指定された時間だけ待ってください。 - サービスのダッシュボードで、残高、課金状態、1日あたりのクォータ、リクエスト上限、モデル固有の制限を確認します。
- 現在のプランまたはAPIキーの同時実行数上限を確認し、同時実行数と最大出力トークンを減らし、プロンプトを短くします。同じAPIキーで複数のコーディングエージェントを同時に実行しないでください。
- 最小リクエストは成功するものの、現在のClaude Code、Codex、Cursorセッションで429が続く場合は、タスクを停止して少し待ち、新しいチャットまたはセッションで再試行します。
- 429が続く場合は、発生時刻、モデル名、ベースURL、クライアントツール、エラーメッセージ全文を添えてサポートへ連絡し、アカウントプールの容量、クォータ、ルート単位のスロットリングを確認してもらいます。
