API 错误码查询

原因：API Key 无效或已过期。密钥可能被重置、格式错误或已删除。 解决方案：检查 Authorization Header 是否为 Bearer sk-xxx 格式，进入「API密钥」页面验证密钥状态。

原因：API 端点 URL 不正确。可能是 base_url 配置错误或拼写错误。 解决方案：确认 base_url 正确，请求路径为 /v1/chat/completions （末尾不带斜杠）。

Question 1

401 未授权

Accepted Answer

原因：API Key 无效或已过期。密钥可能被重置、格式错误或已删除。解决方案：检查 Authorization Header 是否为 Bearer sk-xxx 格式，进入「API密钥」页面验证密钥状态。

Question 2

429 请求限流

Accepted Answer

原因：请求频率超过账户速率限制。普通用户 60次/分钟，企业 300次/分钟。 解决方案：降低并发数（建议 10-20），加入 50-200ms 请求间隔，或升级套餐/联系商务提额。

Question 3

503 服务不可用

Accepted Answer

原因：上游模型服务正在维护或发生波动。常见于 OpenAI / Anthropic 计划性维护期间。 解决方案：平台自动重试，通常几分钟恢复。持续 5 分钟未恢复建议切换备选模型。不扣费。

Question 4

500 服务器内部错误

Accepted Answer

原因：服务端处理请求时发生未预期错误，通常为瞬时故障。 解决方案：等待 30 秒后重试。如频繁出现（1 小时内 >5 次），联系技术支持并提供调用日志。

Question 5

400 参数错误

Accepted Answer

原因：请求体 JSON 格式不正确，或必填字段缺失（model / messages）。 解决方案：检查 JSON 结构，确认 model 字段值正确、messages 为数组格式、每条消息含 role 和 content。

Question 6

402 余额不足

Accepted Answer

原因：账户余额不足以支付本次请求。通常发生在余额接近 0 时的大 token 请求。 解决方案：前往「充值中心」充值。微信/支付宝即时到账后立即恢复调用。

Question 7

403 访问被拒

Accepted Answer

原因：请求 IP 不在密钥的白名单内，或请求的模型不在可调用范围内。 解决方案：检查「API密钥」页面的 IP 白名单设置，确认目标模型是否在密钥的模型白名单中。

Question 8

404 路径不存在

Accepted Answer

原因：API 端点 URL 不正确。可能是 base_url 配置错误或拼写错误。解决方案：确认 base_url 正确，请求路径为 /v1/chat/completions（末尾不带斜杠）。

Question 9

408 请求超时

Accepted Answer

原因：请求在规定时间内未完成。绘画类 API（10-30秒生成）常见此问题。 解决方案：将客户端超时设为 120 秒。降低图片分辨率（1024 → 768）可加速 30-50%。

Question 10

422 参数校验失败

Accepted Answer

原因：请求参数值超出有效范围。如 temperature 不在 0-2、max_tokens 超过模型上限。 解决方案：参照 API 文档中各模型参数限制表，调整参数值到有效范围内。

错误码查询