排错与安全
错误码速查
看到 401、402、404、429、5xx 时,下一步该做什么。
约 5 分钟适合:请求报错、想快速定位原因的用户
开始之前
- 拿到完整的 HTTP 状态码和错误体(不是只看软件里的一句提示)
步骤 1 · STEP 0x01
先认出错误长什么样
response
HTTP/2 402{"error":{"message":"…","type":"insufficient_quota","code":"insufficient_quota"}}
OpenAI 兼容接口的错误体是 { error: { message, type, code } };Anthropic 原生接口(/v1/messages)的错误体是 { type: "error", error: { type, message } }。看 code 或 type 字段最准。
步骤 2 · STEP 0x02
对照速查表
| HTTP | code | 意思与下一步 |
|---|---|---|
| 400 | invalid_request_error / context_length_exceeded | 请求参数不对,或内容超过模型的上下文长度。检查参数;缩短输入。 |
| 401 | invalid_api_key | Key 不对、被吊销或过期。重新复制,或到「API Key」页确认状态。 |
| 402 | insufficient_quota / daily_limit_exceeded | 余额不足,或达到账户日上限。去充值;受限账户看页面顶部的说明。 |
| 403 | permission_denied | 账户被暂停,或这把 Key 被 IP / 模型白名单限制。检查账户状态和 Key 设置。 |
| 404 | model_not_found | 模型名写错,或该模型没开卖 / 不支持这个接口。从模型广场复制名字,看接口标签。 |
| 429 | rate_limit_exceeded / key_budget_exceeded | 请求太快,或这把 Key 的预算用完。按 Retry-After 等待并指数退避;预算用完时调整预算。 |
| 500 | internal_error | 我们这边出错。稍后重试;持续出现就提交工单,附上 request_id。 |
| 502 / 504 | upstream_error / upstream_timeout | 模型服务商出错或超时。稍后重试,看状态页是否有异常。 |
| 503 | service_unavailable | 暂时没有可用的服务商。稍后重试;长时间持续请看状态页和公告。 |
429 和 5xx 可以自动重试:等 1 秒、2 秒、4 秒……逐步拉长,并设置最多重试次数。400、401、402、403、404 重试没有用,先改原因。
步骤 3 · STEP 0x03
报给客服时带什么
request_id(在控制台「用量」页每条请求上,复制即可)- 发生的时间(带时区)、模型名、完整的状态码和错误体
- 不要发 Key、也不要发你的 prompt 原文
怎么提工单见「怎么提工单」(仅中文站);英文用户直接在控制台「Tickets」里新建即可。
✓ 怎么确认成功了
- 你能说出这个错误码对应的原因,并知道下一步该改什么、还是该重试。
常见问题
为什么同一个请求有时 200 有时 503?
模型服务商可能短时不稳定。平台会在首个字节发出前自动切换备用路线,但仍然可能偶发失败,所以客户端要做重试。
错误的请求会扣费吗?
没有产生有效结果的请求一般不收费;流式输出中途失败,按已经生成的 token 计费。具体看用量明细里的「消费」。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。