Gemini API 429 RESOURCE_EXHAUSTED — クォータとレート制限を正しく解決する

RESOURCE_EXHAUSTEDはGeminiの包括的な429エラーです。1分後に解消するならレート制限に達しており、バックオフで解決します。太平洋時間の午前0時まで続くなら、無料枠の日次クォータを使い切っています。再試行ループでは解決できず、課金を有効にするか別の経路を使う必要があります。

エラー

response (HTTP 429)

{
  "error": {
    "code": 429,
    "message": "Resource has been exhausted (e.g. check quota).",
    "status": "RESOURCE_EXHAUSTED"
  }
}

原因と対処法の概要

原因	対処法
毎分のレート制限（RPM/TPM）	ジッター付きでバックオフし、バーストを平滑化します。約60秒以内に解消します。
無料枠の日次リクエストクォータを使い切った	日次リセットまで待つか、課金を有効にする、クォータを増やす、または有料ゲートウェイ経由にします。
1つのキーを共有する多数のワーカー	クォータはワーカー単位ではなくプロジェクト単位です。レートリミッターを中央集約するか、複数のプロジェクトまたはキーに分散します。

分類：分単位の制限か日次クォータか

60秒後に1回再試行します。成功した場合は分単位のレート制限です（バックオフを追加して先へ進みます）。それでも429なら日次クォータです。Cloud Console → Quotasで、どのカウンターが100%になっているかを確認してください。

分単位の制限の場合：標準のバックオフ

あらゆる429と同じパターンです。指数関数的でジッター付きにし、再試行可能なステータスだけを再試行します。Claude 429ガイドのスニペットをそのまま再利用できます。プロバイダーに依存しません。

日次クォータの場合：経済性を変える

無料tierのクォータはプロトタイピング向けです。本番環境では、プロジェクトで課金を有効にするか、上限が日次カウンターではなくウォレット残高になる従量課金ゲートウェイが必要です。選択前にトークン単価を比較してください。

Kunavo経由で呼び出している場合

Kunavoでは、Gemini 2.5 Flash/Proを1つの前払いウォレットで従量課金利用できます。使い切ってしまうような無料枠の日次カウンターはなく、失敗したリクエストには課金されません。AI Studioの日次クォータに繰り返し引っかかるワークロードでは、トークン単価（Googleの定価を大幅に下回ります）は、プロジェクトの分割に費やすエンジニアリング時間のコストより通常は安価です。

よくある質問

Geminiの無料tierクォータはいつリセットされますか？

日次クォータは太平洋時間の深夜にリセットされます。毎分の制限は、移動する60秒ウィンドウでリセットされます。

バックオフでRESOURCE_EXHAUSTEDは解決しますか？

毎分の制限の場合だけです。日次クォータを使い切ると、リセットまで再試行するたびに429が返ります。このケース（60秒待っても429が続く場合）を検出し、再試行で時間を浪費するのを止めてください。