错误码

请求失败时返回对应的 HTTP 状态码,响应体中的 error.message 说明具体原因。

{
  "error": {
    "message": "Insufficient balance",
    "type": "billing_error"
  }
}
状态码含义建议处理
400请求格式错误,如缺少 model 或 messages检查请求体
401API Key 无效或已停用确认密钥完整且未被停用
402账户余额不足充值后重试
403账户已被停用联系管理员
404模型或会话不存在核对 model 或 conversation_id
429达到每日用量上限,或上游限流次日恢复,或稍后重试
502上游模型服务异常稍后重试一次,仍失败请换模型
503该模型暂不可用换用其他模型,或稍后再试

调用失败不扣费。Claude Code 入口(/api/anthropic)的错误按 Anthropic 格式返回,状态码含义相同。