错误码对照

遇到报错时，先在这里找到对应的含义和处理办法。

401 Unauthorized

含义：密钥无效、不完整，或没有正确传递。

排查：

• 确认 API Key 完整，以 sk- 开头，没有多余空格或换行
• 只填 Key 本身，不要手动加 Bearer 前缀（客户端会自动加）
• 确认密钥没有在站点被删除
• 检查客户端是否还残留着旧供应商或旧密钥

403 Forbidden

含义：密钥有效，但没有访问目标模型的权限。

排查：

• 确认密钥的分组是 default（本站只有这一个分组）
• 确认密钥没有被设置模型白名单限制

404 Not Found

含义：请求的地址不对，通常是把路径写全了。

排查：

• Base URL 只写到 /v1 为止
• 不要写成 /v1/chat/completions、/v1/responses 这类完整路径
• Claude Code 的 ANTHROPIC_BASE_URL 不要带 /v1

429 Too Many Requests

含义：请求过快、并发过高，或上游暂时满载。

排查：

• 停止连续重试，等待片刻再试
• 降低并发数，或把长任务拆小
• 常见提示文字：exceeded retry limit、rate limit

500 / 502 Bad Gateway

含义：协议不匹配、地址错误，或上游线路异常。

排查：

• Codex 类客户端确认协议选的是 Responses API
• Base URL 末尾不要出现 /responses
• 关闭可能重复接管请求的本地代理或路由工具后重试

503 Service Unavailable

含义：没有找到可用的渠道，最常见的原因是模型名写错。

排查：

• 对照 模型与价格 检查模型名拼写
• 注意不要添加后缀，例如 claude-opus-5-5-high 是错的
• 常见提示：No available channel for model xxx

余额不足

含义：账号余额已用完。

处理：前往「钱包」页面充值。

连接超时 / stream disconnected

含义：网络或代理问题。

排查：

• 先临时关闭系统代理或 VPN 测试
• 如果必须使用代理，把 gemini.hero1157.com 加入直连规则
• 检查是否有多个代理工具同时运行造成冲突

模型返回空内容

含义：通常不是故障，而是推理模型的思考过程占满了输出额度。

处理：

• 增大 max_tokens（建议至少 200）
• 部分推理模型会先输出思考内容，再输出正文，额度太小会导致正文被截断

联系客服前请准备

为了更快定位问题，请联系我们前准备好：

• 完整报错截图（密钥请打码，只保留前后几位）
• 使用的客户端名称
• 出问题的时间
• 使用的 BASE URL 和模型名

不要发送完整密钥

任何情况下都不要把完整 API Key 发给别人。如果怀疑泄露， 立即到「API 密钥」页面删除并重新创建。