限流 429 api proxy
Error 429 Too Many Requests
连续 429 多半是上游账号池限流、冷却或额度耗尽。先让服务商换号、换线路或换模型,再用最小请求排除本地并发、余额和重试循环问题。
错误摘要
报错:exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>。AI 中转站里连续 429 多半是上游账号池限流、冷却或额度耗尽,先让服务商换号、换线路或换模型。
#error 429
#429 too many requests
#openai api 429
#claude code 429
#codex 429
#exceeded retry limit 429
这个错误是什么意思
Error 429 表示服务端理解了请求,但当前不愿意继续处理,因为请求频率、并发、token 消耗或账号额度触发了限制。
在 AI 中转站里,重点看中转站背后的上游账号池,而不是反复重试同一个 API Key。只要账号池已经冷却或耗尽,继续重试只会把 429 放大。
常见原因
- 中转站背后的上游账号池触发限流、进入冷却,或可调度账号已经没有可用额度。
- 当前模型通道没有可用计费、模型级限制被打满,或该线路暂时没有健康账号。
- 中转站对你的 API Key 做了限流,即使其他账号池或上游官方 API 还有容量,也可能返回 429。
- Claude Code、Codex、Cursor 或其他工具可能会自动重试失败请求,把一次失败变成很多次请求。
- 高上下文 prompt、流式任务、批处理任务或 coding agent 循环可能比普通聊天更快消耗 token。
AI 中转站报 429 怎么排查
先用相同的 Base URL、API Key 和模型名发一个最小请求。如果最小请求也返回 429,问题更可能在额度、计费、provider 限制或中转站限流。
如果最小请求正常,但 coding tool 失败,重点检查并发和重试循环。Coding agent 在读文件、调用工具、恢复失败步骤时,可能快速发出很多请求。
AI 中转站报 429 怎么解决
- 先等待再重试。如果响应里有
Retry-Afterheader,按它给出的时间等待,不要立刻重复发送同一个请求。 - 检查服务商控制台里的余额、计费状态、每日额度、请求限制和模型级限制。
- 确认当前中转站套餐或 API Key 支持的并发数上限,再降低并发、减少 max output tokens、缩短 prompt,避免多个 coding agent 会话共用同一个 API Key 同时跑。
- 如果当前 Claude Code、Codex 或 Cursor 会话连续出现 429,但最小请求本身正常,可以先停止当前任务,等待一段时间后新开一个对话或新会话重试。
- 如果 429 持续出现,联系中转站售后客服,并附上报错时间、模型名、Base URL、请求工具和完整错误信息,让客服确认是否是账号池、额度或线路限流。