Gemini API のクォータ超過(429 RESOURCE_EXHAUSTED)
Gemini API は、レート制限または 1 日のクォータを超えると、429 RESOURCE_EXHAUSTED を返します。無料枠では、上限が小さく設定されています。このページでは、このエラーの各形式、現在の無料の上限、有効な対処法を説明します。
コード、モデル名、ライブのカタログラベルは英語で表示します。
エラーの見え方
Google の開発者フォーラムに投稿された、典型的な無料枠のエラーには、次の要素があります。
無料枠での 429 の例
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricは、何が上限に達したかを示します。generate_content_free_tier_requestsは、無料枠のリクエスト数を数えます。quotaIdは、期間を示します。PerDayは 1 日のクォータです。PerMinuteの ID は、1 分あたりの上限です。limitは、その期間におけるそのモデルのクォータです。Please retry inは、Google が提案する待機時間を示します。
3 つの 429 コードと 1 つの 403
Google の API エラーのページには、HTTP 429 の 3 つのエラーコードと、関連する 403 が記載されています。
| コード | HTTP | 意味 | 対処 |
|---|---|---|---|
rate_limit_exceeded | 429 | 1 分あたりまたは 1 秒あたりのリクエスト数またはトークン数の上限に達した | 指数バックオフで再試行する |
quota_exceeded | 429 | 1 日のクォータを使い切った | リセットまで待つか、上限の引き上げを申請する |
too_many_requests | 429 | 短い期間にリクエストが多すぎる | 指数バックオフで再試行する |
permission_denied | 403 | プロジェクトが制限されているか、このプロジェクトでは無料枠を利用できない | 課金アカウントをリンクして、有料枠を使用する |
1 分の上限は 1 分未満で解除されます。1 日のクォータは、リセット時にのみ解除されます。Google は、1 日のリクエスト数を太平洋時間の深夜にリセットします。リセット前に 1 日のクォータのエラーを再試行しても、リクエストが無駄になります。
本日の無料枠の上限
Google は、上限をキーごとではなく、Google Cloud プロジェクトごとに適用します。上限はモデルごとに異なります。Google は、有効な上限を AI Studio に表示します。この表は、FreeLLMAPI カタログにある無料の Gemini と Gemma の上限を示します。
| モデル | 無料で利用可能 | コンテキスト | 無料枠の上限(最良の条件) | ツール | 画像入力 |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | はい | はい |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.8 Live | Google AI Studio | - | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | いいえ | いいえ |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | いいえ | いいえ |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | いいえ | はい |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
一致する無料モデル 21 件のうち 12 件を表示しています。 すべてのモデルを見る.
FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。
ほとんどの Flash モデルは、無料枠で 1 日約 20 リクエストを許可します。Gemma のモデルは、1 日により多くのリクエストを許可しますが、コンテキストウィンドウは小さくなります。Google は、示された上限を保証しないこと、実際の処理能力は変わる場合があることを述べています。
有効な対処法
quotaIdを読みます。PerDayを含む場合は、停止し、太平洋時間の深夜のリセットまで待ちます。- 1 分の上限の場合は、ジッター付きの指数バックオフで再試行します。再試行の最大回数を設定してください。
- 単純なタスクは、1 日の上限が大きいモデルに移します。例えば、Gemma または Flash-Lite のモデルです。
- 送信するトークンを減らしてください。大きいプロンプトは、1 分あたりのトークン数の上限にすぐ達します。
max_tokensを非常に小さい値にしないでください。Gemini Flash は、出力の上限の中で、非表示の思考トークンを使用することがあります。
| 試す方法 | 効果があるか | 理由 |
|---|---|---|
| 同じプロジェクトで新しい API キーを作成する | いいえ | 上限はプロジェクトに適用されます。Google によると、新しいキーではエラーは解決しません。 |
| プロジェクトを有料枠にアップグレードする | 有料のクォータを得られる | Google によると、有料枠では無料枠のクォータは得られません。有料の利用には課金されます。 |
retry in の時間まで待つ | はい。1 分の上限の場合 | 1 分の期間が切り替わるため |
| 別のモデルに変更する | はい | モデルごとに個別のクォータがあるため |
送信する前にクォータを確認する
エラーの前に問題を確認できます。AI Studio で、Gemini API のドキュメントにあるレート制限のページを開いてください。プロジェクトの、モデルごとの有効な上限が表示されます。Projects ページには、お使いの階層が表示されます。
FreeLLMAPI を使用している場合は、ゲートウェイに、今すぐ使用できるモデルを尋ねてください。ステータスが exhausted のモデルは、すべてのキーがクールダウン中です。このステータスは、クールダウンが終わると自動的に解除されます。
今回答できるモデルを一覧表示する
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"簡単な数値で、毎日の利用を計画してください。1 日 20 リクエストの場合、Flash モデル 1 つでは、1 日を通して約 72 分ごとに 1 リクエストになります。コーディングエージェントは、1 つのタスクで 20 リクエストを使うことがあります。Flash モデルは難しいタスクのみに使い、単純なタスクは 1 日の上限が大きいモデルに送ってください。
ほかの無料プロバイダーにフェイルオーバーする
1 日約 20 回の Flash リクエストでは、Gemini のキーが 1 つでは、エージェントの作業には足りません。FreeLLMAPI は、Gemini を 1 つのエンドポイントの背後に、ほかの無料プロバイダーと一緒に配置します。Gemini が 429 を返すと、ルーターはリクエストをチェーン内の次のモデルに送信します。
- ルーターは、モデルとキーごとに RPM、RPD、TPM、TPD を数えます。既知の上限に達する前に停止します。
- 短い 429 が発生すると、そのキーは 90 秒間のクールダウンになります。1 日のクォータを使い切った場合は、より長いクールダウンになります。2 分、10 分、1 時間、次に 24 時間です。
- Google が、より長い再試行時間を示した場合は、ルーターは Google の値を使用します。
X-Fallback-Trailヘッダーには、失敗した各経路が表示されます。例えば、google/gemini-2.5-flash key1=rate_limitedです。
Gemini のトラフィックをゲートウェイ経由で送信する
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'Gemini CLI は、ゲートウェイのネイティブの /v1beta のサーフェスも使用できます。ゲートウェイは Gemini のクォータを追加しません。Gemini が上限に達した場合は、ほかのプロバイダーを使用します。
Gemini の既知の注意点
| プロバイダー | 既知の問題 | 対処方法 |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。
よくある質問
Gemini API の 429 RESOURCE_EXHAUSTED は何を意味しますか?
プロジェクトがレート制限またはクォータを超えたことを意味します。エラーの本文にある quotaId で、1 分の上限か 1 日のクォータかがわかります。
Gemini の無料枠のクォータはいつリセットされますか?
1 日あたりのリクエスト数は、太平洋時間の深夜にリセットされます。1 分の上限は、1 分以内にリセットされます。
新しい Gemini API キーでクォータのエラーが解決しないのはなぜですか?
Google は、上限をキーではなく Google Cloud プロジェクトに適用します。同じプロジェクト内のすべてのキーは、同じクォータを共有します。
Gemini のクォータエラーの limit: 0 は何を意味しますか?
そのモデルについて、その期間にプロジェクトの無料クォータがないことを意味します。一部のプロジェクトは、無料枠の対象外です。AI Studio で上限を確認するか、別のモデルを試してください。
コーディングエージェントで Gemini の 429 エラーを避けるには?
1 つのゲートウェイの背後で、複数の無料プロバイダーを使用してください。Gemini が上限に達すると、ゲートウェイはリクエストを別のプロバイダーに送信するため、エージェントは処理を続けられます。
関連ガイド
- 無料LLM APIのレート制限
- free gemini api
- カスタムエンドポイントと無料モデルで使う Gemini CLI
- Groq のレート制限に達した (429)
- NVIDIA NIM APIのレート制限
出典
- Google AI Studio: Rate limits (確認日 20 November 2026)
- Google AI Studio: API errors (確認日 20 November 2026)
- Google AI Studio: Troubleshooting (確認日 20 November 2026)
- Google developer forum: free tier quota error example (確認日 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (確認日 20 November 2026)
- FreeLLMAPI docs: Response headers (確認日 20 November 2026)