错误

失败请求返回带 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。静默协议转换只用于文本模型。

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