限流 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 放大。

常见原因

  1. 中转站背后的上游账号池触发限流、进入冷却,或可调度账号已经没有可用额度。
  2. 当前模型通道没有可用计费、模型级限制被打满,或该线路暂时没有健康账号。
  3. 中转站对你的 API Key 做了限流,即使其他账号池或上游官方 API 还有容量,也可能返回 429。
  4. Claude Code、Codex、Cursor 或其他工具可能会自动重试失败请求,把一次失败变成很多次请求。
  5. 高上下文 prompt、流式任务、批处理任务或 coding agent 循环可能比普通聊天更快消耗 token。

AI 中转站报 429 怎么排查

先用相同的 Base URL、API Key 和模型名发一个最小请求。如果最小请求也返回 429,问题更可能在额度、计费、provider 限制或中转站限流。

如果最小请求正常,但 coding tool 失败,重点检查并发和重试循环。Coding agent 在读文件、调用工具、恢复失败步骤时,可能快速发出很多请求。

AI 中转站报 429 怎么解决

  1. 先等待再重试。如果响应里有 Retry-After header,按它给出的时间等待,不要立刻重复发送同一个请求。
  2. 检查服务商控制台里的余额、计费状态、每日额度、请求限制和模型级限制。
  3. 确认当前中转站套餐或 API Key 支持的并发数上限,再降低并发、减少 max output tokens、缩短 prompt,避免多个 coding agent 会话共用同一个 API Key 同时跑。
  4. 如果当前 Claude Code、Codex 或 Cursor 会话连续出现 429,但最小请求本身正常,可以先停止当前任务,等待一段时间后新开一个对话或新会话重试。
  5. 如果 429 持续出现,联系中转站售后客服,并附上报错时间、模型名、Base URL、请求工具和完整错误信息,让客服确认是否是账号池、额度或线路限流。

相关错误

Claude Code / Codex 503 No available accounts:中转站账号池不可用排查 先不要盲目换 Key。这个错误通常说明账号池、供应商、分组或模型路由暂时不可用。先测最小请求、确认模型和分组,再判断是等待恢复、降低上下文,还是换 provider。 Codex: Selected model is at capacity. 模型容量已满排查 报错:Selected model is at capacity. Please try a different model. 先把它当作模型级容量、Admission 或流式中断问题处理。它可能出现在官方 ChatGPT 登录态 Codex CLI,也可能来自中转站账号池或 Sub2API 上游 overloaded 透传。 Codex 提示:你的对话中有多个可能的网络安全风险的标记 提示:你的对话中有多个可能的网络安全风险的标记。先把它当作 OpenAI/Codex 安全路由触发,而不是直接判断账号或中转站故障;再检查是否使用了中转 API、敏感关键词、超长代码上下文或不透明模型路由。 Error 401 Unauthorized:AI API 中转站认证排查 401 是认证失败信号。先检查当前加载的是哪一个 Key、请求打到哪个 Base URL、header 格式是否正确,以及这个 Key 是否仍然在对应 provider 中有效。 中转站报错 API Error 502 origin_bad_gateway 排查步骤 报错:API Error 502、Error 502: Bad gateway、error_name: origin_bad_gateway、cloudflare_error: true。先看中转站状态页;如果目标模型或线路全红,停止反复改 Key 和重试,直接联系在线客服或站长确认号池与恢复时间。 Codex 提示:此聊天已被标记为可能存在网络安全风险 Codex 提示“此聊天已被标记为可能存在网络安全风险”时,先不要把它当作中转站故障或封号。它更像是系统级网络安全风险标记;普通开发误触发时,优先新开会话、缩小上下文、重新表述任务。 Codex: gpt-5.6-sol model is not supported with a ChatGPT account 报错:The 'gpt-5.6-sol' model is not supported when using Codex with a ChatGPT account. 先把它当作 ChatGPT 账号权限、订阅层级或灰度入口问题处理;可先切到 Terra/Luna,或改用 API Key/provider 配置。 Codex 找不到 MCP 工具:tool does not exist in this session's available toolset Codex 提示 MCP tool does not exist in this session's available toolset 时,先核对服务和工具发现状态,再用全新会话、codex doctor、官方 provider 与版本 A/B 判断是缓存、客户端回归还是自定义 provider 没有暴露工具。 Codex MCP 报错 Unexpected response type Codex MCP 报 Unexpected response type 时,先确认错误发生在 tools/call 返回之后,再用 MCP Inspector、直接客户端或旧版 Codex 做对照;服务端可临时简化返回内容,普通用户则应保留版本和工具名等待兼容修复。 Codex:当前环境没有提供可用的终端或文件编辑工具怎么解决 先 fork 当前对话,在新任务中回复“继续”让 Codex 重新执行。如果仍然没有工具,用 GPT-5.5 和手动 `!命令` 做一次对照测试。 Codex 报错 stream disconnected before completion Codex 报 stream disconnected before completion: error sending request for url 时,先不要急着换账号或改模型。它通常是终端网络、代理继承、中转站 Responses 兼容性或上游 SSE 流断开的信号。 Codex 报错 stream disconnected before completion: Upstream request failed Codex 报 stream disconnected before completion: Upstream request failed 时,不要只凭浏览器能上网就排除网络,也不要只凭 curl hello 能通就认定中转站没问题。先看 URL、upstream_error、response.failed、request id 和是否使用自定义 provider,再按官方链路、本地代理和中转站链路分开排查。 Codex 报错 Error creating task: Timeout / Unable to start task Codex 报 Error creating task: Timeout、Task creation timeout 或 Unable to start task 时,先测试已有任务,再临时禁用无法连接或路径失效的 MCP 服务并完全重启桌面端。

相关教程

相关主题

常见问题

常见问题

Error 429 一定是服务商挂了吗?

不一定。它更常见是限流、额度、计费或重试循环问题。先看余额、请求限制和 Retry-After,再判断是不是服务商故障。

为什么 Codex 或 Claude Code 更容易遇到 429?

Coding agent 会读文件、规划修改、调用工具、重试失败请求。一次交互任务可能比普通聊天消耗更多请求数和 token。

遇到 429 要立刻换中转站吗?

不要先换中转站,先让当前中转站换可用账号、换线路或换模型。只有多个账号池或线路都持续 429,且最小请求也失败时,换 provider 才有意义。