适用范围与准备

适用于调用 OpenAI API 时响应里带有 HTTP 状态码。浏览器只显示打不开、没有状态码时,先走网页错误代码,不要套用本篇。本篇不改网络,也不把接口地区限制写成可以绕过。

先区分原因

官方错误码把原因分开。401 是认证:密钥不对、组织不对、账号不在组织里,或请求 IP 不在项目或组织的允许列表里。403“Country, region, or territory not supported”是从不支持的国家、地区或属地访问 API,文档要求去看支持地区说明。429 里还有多类:预付费额度用尽、请求太快、请求增速过快、组织或项目花费上限、组织用量上限。账单、花费和配额类错误,重试不会恢复访问,要先改额度或上限。500 是服务器处理出错,短暂等待后重试,并查看状态页。503 且代码为 server_is_overloaded 是模型暂时过载,有 Retry-After 时先按它等待。

按顺序操作

  1. 记下 HTTP 状态、error.type 和 error.code。没有这三项的浏览器失败页,不归到本篇。
  2. 401 时核对密钥、组织和权限。提示 IP not authorized 时,文档写的是从允许的 IP 发送,或更新 IP 允许列表。不要换一条未登记的出口再重试。
  3. 403 且说明地区不支持时,打开文档给出的支持地区页面。重试同一请求不会把地区错误变成成功。
  4. 429 先看 code。credit_balance_exhausted、organization_spend_limit_exceeded、project_spend_limit_exceeded、organization_usage_limit_exceeded 都要改额度或上限。rate limit 和 slow_down 才按 Retry-After 放慢,并逐步提高速率。
  5. 500 查看 status.openai.com 后再短等重试。503 且为 server_is_overloaded 时,按 Retry-After 重试。不要把这两种和额度用尽写成同一次重试。

状态码对照

状态文档中的处理
401核对密钥、组织、成员身份或 IP 允许列表
403 地区不支持查看支持地区说明,不要把重试当成解决
429 额度或花费上限补充额度或调整上限;重试不会恢复
429 请求过快或 slow_down按 Retry-After 放慢,再逐步提高
500 / 503 过载服务器或模型暂时不可用,按文档等待后重试

怎样确认有效

同一请求在你改的那一项之后,状态码发生变化,才说明改对了位置。额度类 429 在补上额度之前重复出现,符合文档,不是网络抖动。

无效时恢复与下一步

本篇没有要求改系统代理。新生成的密钥若不用,从账号设置里撤销,保留原来仍有效的那一把。