适用范围与准备
适用于调用 OpenAI API 时响应里带有 HTTP 状态码。浏览器只显示打不开、没有状态码时,先走网页错误代码,不要套用本篇。本篇不改网络,也不把接口地区限制写成可以绕过。
先区分原因
官方错误码把原因分开。401 是认证:密钥不对、组织不对、账号不在组织里,或请求 IP 不在项目或组织的允许列表里。403“Country, region, or territory not supported”是从不支持的国家、地区或属地访问 API,文档要求去看支持地区说明。429 里还有多类:预付费额度用尽、请求太快、请求增速过快、组织或项目花费上限、组织用量上限。账单、花费和配额类错误,重试不会恢复访问,要先改额度或上限。500 是服务器处理出错,短暂等待后重试,并查看状态页。503 且代码为 server_is_overloaded 是模型暂时过载,有 Retry-After 时先按它等待。
按顺序操作
- 记下 HTTP 状态、error.type 和 error.code。没有这三项的浏览器失败页,不归到本篇。
- 401 时核对密钥、组织和权限。提示 IP not authorized 时,文档写的是从允许的 IP 发送,或更新 IP 允许列表。不要换一条未登记的出口再重试。
- 403 且说明地区不支持时,打开文档给出的支持地区页面。重试同一请求不会把地区错误变成成功。
- 429 先看 code。credit_balance_exhausted、organization_spend_limit_exceeded、project_spend_limit_exceeded、organization_usage_limit_exceeded 都要改额度或上限。rate limit 和 slow_down 才按 Retry-After 放慢,并逐步提高速率。
- 500 查看 status.openai.com 后再短等重试。503 且为 server_is_overloaded 时,按 Retry-After 重试。不要把这两种和额度用尽写成同一次重试。
状态码对照
| 状态 | 文档中的处理 |
|---|---|
| 401 | 核对密钥、组织、成员身份或 IP 允许列表 |
| 403 地区不支持 | 查看支持地区说明,不要把重试当成解决 |
| 429 额度或花费上限 | 补充额度或调整上限;重试不会恢复 |
| 429 请求过快或 slow_down | 按 Retry-After 放慢,再逐步提高 |
| 500 / 503 过载 | 服务器或模型暂时不可用,按文档等待后重试 |
怎样确认有效
同一请求在你改的那一项之后,状态码发生变化,才说明改对了位置。额度类 429 在补上额度之前重复出现,符合文档,不是网络抖动。
无效时恢复与下一步
本篇没有要求改系统代理。新生成的密钥若不用,从账号设置里撤销,保留原来仍有效的那一把。