报错 · openai-api
OpenAI API 出现 429:先分清速率限制与额度问题
根据官方错误码和响应头判断 OpenAI API 429,避免把临时速率限制误判成 Codex 套餐额度耗尽。
最后核验:2026年9月15日
直接答案
HTTP 429 本身不能证明你的 ChatGPT 或 Codex 套餐额度已经用完。对于 OpenAI API,请继续检查 error.code 和响应头;slow_down 表示请求速率上升过快,应遵循 Retry-After 并降低请求速度。
适用范围
适用于使用 API Key 调用 OpenAI API 的程序,不适用于 ChatGPT 套餐内的 Codex 用量提示。
操作步骤
- 1先确认请求来自 API Key,而不是 ChatGPT 套餐中的 Codex。
- 2记录 HTTP 状态、error.code 和 x-request-id,但不要记录 API Key。
- 3若 error.code 为 slow_down,等待至少 Retry-After 指定的时间,并加入随机退避。
- 4检查 x-ratelimit-remaining-* 与 x-ratelimit-reset-*,区分请求数和 Token 限制。
- 5若错误属于余额、账单或需要人工处理的额度问题,不要无休止重试。
常见误区
- 所有 429 都会在同一个固定时刻恢复。
- 不断立即重试可以更快恢复;失败请求也可能继续计入速率限制。
下一步
保留脱敏后的错误码与响应头,再根据具体错误类型决定等待、降速或检查账单。
查看最新来源信号 →