文档 · 生产实践

错误码

错误使用标准 HTTP 状态码。OpenAI 格式接口返回 OpenAI 风格的错误体，Anthropic 格式接口返回 Anthropic 风格的错误体。

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

{
  "type": "error",
  "error": { "type": "authentication_error", "message": "invalid x-api-key" }
}

状态码	含义	处理建议
`400`	参数无效、JSON 格式错误、模型不支持该参数，或输入超出上下文长度	检查请求，不要重试
`401`	API Key 缺失、错误或已删除	检查鉴权请求头
`403`	余额不足，或该 Key 已停用 / 无权使用此模型	在控制台检查余额与 Key 设置
`404`	路径错误或模型不存在	检查 Base URL 是否正确（OpenAI SDK 需带 `/v1`）与模型 ID
`413`	请求体过大	压缩图片、裁剪上下文
`429`	请求过于频繁，或上游暂时限流	退避重试，降低并发
`500`	内部错误	可以重试
`502` / `503`	上游暂时不可用	稍后重试
`504`	上游响应超时	使用流式输出，或稍后重试

返回错误的请求不计费。重试策略见最佳实践。