错误

失败请求返回带 error 对象的 JSON。HTTP 状态是第一信号，message 和 code 说明具体失败。

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

常见状态码

状态	常见原因
400	JSON 非法、字段不受支持，或模型走错入口
401	API Key 缺失或无效
403	该 Key 不能使用此模型或分组，或账号付不起这次请求
404	路径未知或任务不存在
429	触发限速
499	客户端取消请求
5xx	服务端或网关失败

图片和视频请求发到错误协议时返回 400，unsupported_endpoint 会指出应使用的 API。静默协议转换只用于文本模型。

余额与额度

账号付不起这次请求时，网关在调用模型之前就返回 403。原因解决之前，重试不会成功。

code	原因
insufficient_user_quota	余额或订阅不够支付这次请求的预估费用。企业成员对应的是共用的企业余额。
enterprise_member_budget_exhausted	企业成员用完了企业分配的额度。见企业账号。

更完整的诊断、重试和回退见主站技术文章，从 AI API 错误排查 开始。