错误码
失败时返回 JSON,并带有 HTTP 状态码。字段名与 OpenAI 风格的 error 对象相近,但具体文案以实际响应为准。
| 状态 | 常见含义 | 您可以先做的事 |
|---|---|---|
| 400 | 请求体无法解析,或该模型不接受某个参数 | 对照对话接口检查 JSON 和模型 ID |
| 401 | 令牌缺失、错误或已作废 | 看 Authorization 是否为 Bearer 加令牌,令牌有没有被禁用 |
| 402 | 账户或该令牌的额度不足 | 到控制台充值,或提高该令牌的额度上限 |
| 429 | 超过当前速率或并发限制 | 降低频率后重试。限制数值以控制台为准,不在本文写死 |
| 500 | 平台内部错误 | 稍后重试。重复出现时把时间和请求 ID 发给【客服邮箱】 |
| 504 | 上游在时限内没有返回 | 缩短输入或输出上限后重试。超时是否计费,见计费与退款 |
处理建议:
- 从响应或网关日志里记下请求 ID,不要只截一张「失败了」的图。
- 402 和 429 不要用换令牌的方式绕过。那会触犯用户协议里的规避计费和限流条款。
- 5xx 可以做有限次重试,并加上退避。无限重试会放大费用和故障。