跳转到内容

错误码

报错时先看 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

下面这些是我们在 2026-11-22 实际触发后拿到的原样返回。

{"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。

{"code":"INVALID_API_KEY","message":"Invalid API key"}

多半是复制时少了字符或多了空格。

{"code":"API_KEY_DISABLED","message":"API key is disabled"}
{"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 page not found

返回的是纯文本,不是 JSON。最常见的原因是 /v1 多写了一次,路径变成了 /v1/v1/chat/completions。Claude Code 和 Anthropic SDK 的地址不带 /v1,OpenAI SDK、Codex、Cursor 的地址要带 /v1。

余额不足、请求太快、Key 过期、额度用完这几种,我们没有在线上专门触发(需要动真实账户),上表的 code 取自服务端源码。

表里没有的报错,把完整的返回内容发给客服(微信 zhao17337630083),我们帮你看。