错误码
报错时先看 HTTP 状态码,再看返回里的 code(或 error.type),对照下表处理。
| HTTP | code / type | 意思 | 怎么办 |
|---|---|---|---|
| 401 | API_KEY_REQUIRED |
请求没带 Key | 检查请求头,见下方 |
| 401 | INVALID_API_KEY |
Key 不对 | 回控制台重新复制 |
| 401 | API_KEY_DISABLED |
Key 被停用了 | 控制台「API Key」页点「启用」 |
| 403 | INSUFFICIENT_BALANCE |
余额不足 | 去「充值」页兑换 |
| 403 | API_KEY_EXPIRED |
Key 过期了 | 新建一把 Key |
| 404 | model_not_found |
分组里没有这个模型 | 换对应分组的 Key,或改模型名 |
| 404 | (纯文本)404 page not found |
地址写错了 | 检查 /v1 有没有多写或漏写 |
| 429 | RATE_LIMITED |
请求太快 | 稍等几秒再试 |
| 429 | API_KEY_QUOTA_EXHAUSTED |
这把 Key 的额度用完了 | 在控制台调高额度,或换一把 Key |
实际返回的样子
Section titled “实际返回的样子”下面这些是我们在 2026-11-22 实际触发后拿到的原样返回。
没带 Key(401)
Section titled “没带 Key(401)”{"code":"API_KEY_REQUIRED","message":"API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"}三种格式的认证头不一样,别混用:OpenAI 格式用 Authorization: Bearer,Anthropic 格式用 x-api-key,Gemini 原生格式用 x-goog-api-key。
Key 不对(401)
Section titled “Key 不对(401)”{"code":"INVALID_API_KEY","message":"Invalid API key"}多半是复制时少了字符或多了空格。
Key 被停用(401)
Section titled “Key 被停用(401)”{"code":"API_KEY_DISABLED","message":"API key is disabled"}分组里没有这个模型(404)
Section titled “分组里没有这个模型(404)”{"error":{"message":"Model \"claude-sonnet-5-5\" is not supported by any configured account in this group","type":"model_not_found"}}这是用 GPT 分组的 Key 调了 Claude 模型。见 分组怎么选。
地址写错(404)
Section titled “地址写错(404)”404 page not found返回的是纯文本,不是 JSON。最常见的原因是 /v1 多写了一次,路径变成了 /v1/v1/chat/completions。Claude Code 和 Anthropic SDK 的地址不带 /v1,OpenAI SDK、Codex、Cursor 的地址要带 /v1。
余额不足、请求太快、Key 过期、额度用完这几种,我们没有在线上专门触发(需要动真实账户),上表的 code 取自服务端源码。
表里没有的报错,把完整的返回内容发给客服(微信 zhao17337630083),我们帮你看。