常见问题
常见报错的原因和解决办法
错误码速查
| 状态码 | 错误信息（关键字） | 原因 | 解决办法 |
|---|---|---|---|
| 401 | API_KEY_REQUIRED | 请求里没有带密钥 | 检查客户端的 API Key 是否填写、是否保存 |
| 401 | 密钥无效 | 密钥填错、多了空格，或密钥已删除 | 重新从控制台复制完整密钥 |
| 400 | api_key_in_query_deprecated | 把密钥放在了 URL 参数里 | 改为在 API Key 字段里填写 |
| 403 | INSUFFICIENT_BALANCE | 账户余额不足 | 在控制台充值 |
| 403 | API_KEY_EXPIRED | 密钥已过期 | 修改过期时间或新建密钥 |
| 403 | not assigned to any group | 密钥没有分组 | 编辑密钥，选择一个分组 |
| 403 | does not allow /v1/messages dispatch | 用 OpenAI 分组的密钥调用了 Claude 协议 | 换用 Anthropic 分组的密钥，或改用 OpenAI 协议的客户端 |
| 403 | restricted to Claude Code clients | 该分组仅限 Claude Code 使用 | 在 Claude Code 中使用，或换其他分组 |
| 403 | Access denied. Your IP is … | 触发了密钥的 IP 白名单 / 黑名单 | 在控制台调整密钥的 IP 限制 |
| 404 | model_not_found | 模型名写错，或当前分组没有这个模型 | 到模型广场复制正确的模型名，确认分组 |
| 404 | 路径不存在 | Base URL 多了或少了 /v1 | 对照 Base URL 速查 |
| 429 | API_KEY_QUOTA_EXHAUSTED | 密钥设置的额度上限已用完 | 调高密钥额度或新建密钥 |