错误码速查

更新于 2026/9/19

网关对请求失败返回统一的错误结构，code 字段为机器可读错误码。

错误码表

HTTP	code	是否计费	说明
400	`invalid_request`	否	请求参数错误
401	`invalid_api_key`	否	API Key 无效或缺失
402	`insufficient_balance`	否	余额不足，请充值
403	`model_not_allowed`	否	模型未授权给该 Key
429	`rate_limit_exceeded`	否	触发限流，请稍后重试
500	`billing_settlement_error`	进入异步对账	计费结算异常
502	`upstream_error`	通常否	上游服务错误
503	`model_provider_unavailable`	否	模型服务暂时不可用
504	`upstream_timeout`	通常否	上游超时

排查建议

401：确认 Authorization: Bearer 后跟的是完整 sk-live-* 明文，且 Key 未被撤销。
402：前往控制台充值。
429：降低并发，或查看响应中的 retry-after 等待后再试。
5xx：稍后重试；若持续出现，请携带 request_id 联系支持。

错误示例

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}