错误

错误包含机器可读代码及消息。请区分被拒请求与可能已消耗提供商资源的不确定结果。

错误格式

JSON 错误

{
  "error": {
    "message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
    "type": "invalid_request_error",
    "code": "insufficient_credit"
  }
}

通过响应的 x-request-id 及活动记录调查请求。切勿在支持报告中包含密钥或对话内容。

状态码

状态	含义 / 操作
400	请求体无效、未知字段、上下文超限或不支持的能力。
401	Bearer 密钥缺失、无效或已撤销。
402	可用额度不足或达到 API 密钥消费限额。
403	账户不可用或模型不在密钥白名单中。
404	未知端点或未审核模型 ID。
409	幂等引用已被使用。
413 / 415	请求体过大或内容类型不是 application/json。
429	速率、请求或并发超限。重试前请等待 Retry-After 指定时间；待处理预留可能需要核对。
502	提供商故障、无效流或用量不可用。
503	维护、提供商就绪或上线配置。

不确定结果

上游超时或 usage_unavailable 响应可能留下待处理预留。这些错误包含 X-Should-Retry: false，阻止 SDK 自动重试。错误码区分模型不可用、无效参数、身份验证、配额和限流，不泄露提供商私有信息。提交新调用前请查看活动并核对首次结果。

幂等性

可选的 Idempotency-Key 包含 1–128 个字母、数字、点、下划线、冒号或连字符。复用会返回 409，且不再次推理。这是防重复，不是重放缓存响应。