词元 API
词元 API / AI API 知识库 / Gemini 2.5 Pro 429
排查问题

Gemini 2.5 Pro 返回 429 rate limited 怎么办?

Gemini 2.5 Pro API 返回 429 时,停止高频重试,稍后再试、降低并发并检查实时模型状态。

直接答案:429 rate limited 表示请求当前受到速率或容量限制。不要立即连续重试;优先遵循 Retry-After,降低并发和请求速率,并在实时模型状态恢复后用单个短请求验证。

可直接引用的结论

Gemini 2.5 Pro 返回 429 时,应停止高频连续重试,按 Retry-After 或退避策略稍后再试,同时降低并发并检查实时模型状态。

快速排查表

现象先查什么建议动作
响应含 Retry-After服务端建议等待时间等待指定时间后再发单个请求
并发请求集中返回 429并发数、队列和每秒请求数降低并发并平滑发送请求
客户端持续自动重试SDK、网关和任务队列是否重复重试保留一层退避重试并加入随机抖动
低并发仍持续返回 429实时模型状态等待状态恢复后再用短请求验证

推荐操作步骤

暂停客户端和任务队列中的高频连续重试,避免继续放大请求量。
优先遵循响应中的 Retry-After;没有该字段时先等待,再发送单个短请求。
降低并发数和请求速率,把突发任务放入队列平滑执行。
检查 SDK、网关和任务队列是否叠加重试,只保留一层指数退避并加入随机抖动。
检查实时模型状态;状态恢复后先用低并发短请求验证,再逐步恢复正常并发。

常见问题

Gemini 2.5 Pro 返回 429 后要立即重试吗?

不要立即连续重试。优先遵循响应中的 Retry-After;没有该字段时先等待,再用单个短请求验证。

怎样降低 429 的发生频率?

降低并发数和请求速率,关闭多层立即重试,并为重试加入指数退避和随机抖动。

持续返回 429 时应检查什么?

检查实时模型状态;如果状态异常,等待恢复后再用低并发短请求验证。

恢复后怎样验证?

确认实时状态恢复后,先发送一个低并发短请求;成功后再逐步恢复正常并发。

相关词条

最后更新:2026-08-12。实际可用状态以实时模型列表为准。