Gemini API 报错 429 RESOURCE_EXHAUSTED 怎么办：速率限制、花费限制与重试（2026）
大约 3 分钟GeminiGemini API429 RESOURCE_EXHAUSTEDGemini rate limitGemini API报错
一句话结论
429 RESOURCE_EXHAUSTED = 超过了限额。可能是每分钟请求数（RPM）、每分钟 token 数（TPM）、每天请求数（RPD），也可能是付费层按 10 分钟计算的花费限制。先在 Google AI Studio 查看项目的当前限额，代码里加指数退避重试；长期不够用就升级用量层级或申请提额。
阅读说明
官方信息查阅日期：2026-10-24。来源：Gemini API 官方文档 Rate limits、Troubleshooting guide。价格以官网为准，可能随地区和税费变化。
限额怎么算
- 三个维度：RPM（每分钟请求数）、TPM（每分钟输入 token 数）、RPD（每天请求数），任意一项超了都会报错。比如 RPM 是 20，一分钟发 21 个请求就会被拒，即使 TPM 没超。
- 按项目计算，不按 API key。
- RPD 在太平洋时间午夜重置。
- 不同模型限额不同；实验和预览模型限额更紧。
- 当前限额在 Google AI Studio 里查看，会随层级和账号状态自动更新。
花费限制（付费层）
除了 RPM / TPM，付费层还有按滚动 10 分钟计算的花费限制，超了同样返回 429 RESOURCE_EXHAUSTED：
| 用量层级 | 每 10 分钟花费上限 |
|---|---|
| Free | 不适用 |
| Tier 1 | 10 美元 |
| Tier 2 | 50 美元 |
| Tier 3 | 200 美元 |
是否适用取决于你的结算历史和账号状态。
怎么处理
- 重试要用指数退避：先等约 1 秒，再 2、4、8 秒依次加长，并加随机抖动，设置最大重试次数。官方 SDK 默认已内置：Python SDK 对瞬时错误最多重试 4 次，初始延迟约 1 秒，最长 60 秒。
- 只对 429、408、5xx 重试；400、402、403 是 key 无效、预付额度用完或语法错误，重试没用。
- 降低昂贵请求的频率：缩短上下文和输出长度。
- 升级层级：免费层在 AI Studio 设置结算后升到 Tier 1；之后累计消费达标会自动升到 Tier 2、Tier 3，见 Gemini API 免费吗。
- 申请提额：在 AI Studio 的速率限制页面提交申请，官方不保证一定批准。
常见问题
我新建了一把 API key，为什么还是 429？
限额按项目算，同一项目里换 key 不会重置限额。
每天的限额什么时候重置？
RPD 在太平洋时间午夜重置，换算成北京时间是下午 3 点或 4 点（夏令时 15:00，冬令时 16:00）。
相关阅读
参考来源（官方）
- Gemini API · Rate limits：https://ai.google.dev/gemini-api/docs/rate-limits（查阅日期：2026-10-24）
- Gemini API · Troubleshooting guide（Retry strategy）：https://ai.google.dev/gemini-api/docs/troubleshooting（查阅日期：2026-10-24）