Gemini API 429 RESOURCE_EXHAUSTED——正確區分配額與速率限制並修復

RESOURCE_EXHAUSTED 是 Gemini 的通用 429 錯誤。如果在一分鐘後消失，表示遇到速率限制——退避即可修復。如果持續到太平洋時間午夜，表示已用完每日免費等級配額——任何重試迴圈都無法修復，只有啟用付款或改用其他路徑。

錯誤

response (HTTP 429)

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

原因	解決方法
每分鐘速率限制（RPM／TPM）	加入抖動的退避；平滑突發流量。會在約 60 秒內解除。
每日免費等級請求配額已用盡	等待每日重設——啟用付款、提高配額，或透過付費閘道轉送。
多個工作者共用一個金鑰	配額是以專案為單位，而不是以工作者為單位——集中管理速率限制器，或分散至多個專案／金鑰。

60 秒後重試一次。成功 → 分鐘級速率限制（加入退避並繼續）。仍為 429 → 每日配額；檢查 Cloud Console → Quotas，確認哪個計數器已達 100%。

與所有 429 相同的模式——指數式、加入抖動，且只重試可重試的狀態。直接重用我們 Claude 429 指南中的程式碼片段；它與供應商無關。

免費等級配額適合原型開發。正式環境需要在專案上啟用付款，或使用隨付隨用的閘道，讓上限取決於您的錢包，而不是每日計數器。選擇前請比較每個 token 的成本。

在 Kunavo，Gemini 2.5 Flash／Pro 使用同一個預付錢包按量付費——沒有可耗盡的每日免費等級計數器，失敗的請求也不會計費。對於持續觸發 AI Studio 每日配額的工作負載，每個 token 的價格（遠低於 Google 定價）通常比花在分割專案上的工程時間更便宜。

每日配額會在太平洋時間午夜重設。每分鐘限制會在滾動的 60 秒視窗中重設。

只有每分鐘配額耗盡的情況可以。每日配額耗盡後，在重設前每次重試都會回傳 429——請偵測這種情況（等待 60 秒後仍持續回傳 429），並停止浪費重試次數。