错误代码

OpenAI 兼容错误格式与常见 HTTP 状态。

错误响应格式

所有错误均采用 OpenAI 兼容格式返回

json

{
  "error": {
    "message": "...",
    "type": "..."
  }
}

HTTP 状态码	type	含义	处理建议
401	`authentication_error`	API Key 缺失或无效	检查 Authorization 头、Key 格式及是否有效
403	`authorization_error`	Key 已禁用或过期	在控制台重新生成 API Key
400	`invalid_request_error`	请求参数错误	检查 model、messages 等必填项及格式
402	`insufficient_balance`	余额不足	前往控制台充值后重试
429	`rate_limit_error`	触发限流	稍等片刻后重试，可配合指数退避
502	`upstream_error`	上游 Provider 返回错误	可稍后重试，或联系管理员
500	`internal_error`	网关内部错误	请联系管理员

针对 429、502 建议实现重试（如指数退避：1s、2s、4s 后重试）。