错误码

API 返回的错误响应格式兼容 OpenAI,包含错误码和错误信息。

报错语言:请求头 Accept-Language 明确指定时以它为准;未携带(如 curl / SDK)时跟随账号语言,默认中文。上游失败时,响应还会带上 upstream_status / upstream_channel / upstream_message,可直接看出是哪家上游、什么状态码出的问题。

状态码错误类型说明
401
invalid_request_errorAPI Key 无效或格式错误
402
insufficient_balance余额不足,请充值后继续使用
403
invalid_request_errorAPI Key 已禁用或已过期
404
not_found_error请求的模型不存在或未启用
429
rate_limit_error请求过于频繁,请稍后重试
500
server_error服务器内部错误,请稍后重试
502
upstream_error上游渠道超时或不可用,建议重试

错误响应格式

JSON
{
  "error": {
    "message": "Insufficient balance. Please recharge to continue.",
    "type": "insufficient_balance",
    "code": "insufficient_balance"
  }
}

上游失败(带诊断字段)

JSON
{
  "error": {
    "message": "该模型上游服务暂时异常(上游状态码 525,渠道 Conatus Free),建议稍后重试或切换其它模型。",
    "type": "upstream_error",
    "code": "upstream_5xx",
    "upstream_status": 525,
    "upstream_channel": "Conatus Free",
    "upstream_message": "Channel Conatus Free returned 525"
  }
}

code 取值:upstream_5xx / upstream_rate_limit / upstream_free_quota / upstream_rejected / upstream_timeout / no_upstream_channel。