错误码
API 返回的错误响应格式兼容 OpenAI,包含错误码和错误信息。
报错语言:请求头 Accept-Language 明确指定时以它为准;未携带(如 curl / SDK)时跟随账号语言,默认中文。上游失败时,响应还会带上 upstream_status / upstream_channel / upstream_message,可直接看出是哪家上游、什么状态码出的问题。
| 状态码 | 错误类型 | 说明 |
|---|---|---|
401 | invalid_request_error | API Key 无效或格式错误 |
402 | insufficient_balance | 余额不足,请充值后继续使用 |
403 | invalid_request_error | API 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。