Gemini API 429 RESOURCE_EXHAUSTED——正确区分配额与速率限制

RESOURCE_EXHAUSTED 是 Gemini 对 429 的统称。如果一分钟后恢复，说明触发了速率限制——退避即可解决。如果持续到太平洋时间午夜，说明已耗尽每日免费层级配额——重试循环无法解决，只有启用计费或切换其他路径才行。

错误

响应（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），并停止继续浪费重试次数。