错误码
请求失败时返回对应的 HTTP 状态码,响应体中的 error.message 说明具体原因。
{
"error": {
"message": "Insufficient balance",
"type": "billing_error"
}
}| 状态码 | 含义 | 建议处理 |
|---|---|---|
400 | 请求格式错误,如缺少 model 或 messages | 检查请求体 |
401 | API Key 无效或已停用 | 确认密钥完整且未被停用 |
402 | 账户余额不足 | 充值后重试 |
403 | 账户已被停用 | 联系管理员 |
404 | 模型或会话不存在 | 核对 model 或 conversation_id |
429 | 达到每日用量上限,或上游限流 | 次日恢复,或稍后重试 |
502 | 上游模型服务异常 | 稍后重试一次,仍失败请换模型 |
503 | 该模型暂不可用 | 换用其他模型,或稍后再试 |
调用失败不扣费。Claude Code 入口(/api/anthropic)的错误按 Anthropic 格式返回,状态码含义相同。