外观
错误码
| HTTP 状态码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求参数错误 | 检查 JSON 字段、模型名和必填参数 |
| 401 | 鉴权失败 | 检查 API Key 是否正确、是否带有 Bearer 前缀 |
| 403 | 无权限 / 额度不足 | 确认 Key 是否有该模型/分组的权限;insufficient_user_quota 表示余额不足,请充值 |
| 404 | 资源不存在 | 检查 Endpoint、模型名是否正确(model_not_found = 模型不存在或不在你的分组内) |
| 429 | 频率限制 | 降低请求频率,稍后重试 |
| 500 | 服务端错误 | 稍后重试,并保留请求 ID 方便排查 |
| 501 | 功能未实现或当前模型不支持 | 检查请求的 Endpoint、协议或模型能力;不要立即重试相同请求 |
| 502 | 网关无法从上游服务获得有效响应 | 使用指数退避后有限重试;持续失败时记录请求 ID 并反馈 |
| 503 | 上游服务暂时不可用 | 平台供应商临时故障或线路切换中,稍后重试或换用其他模型;平台会自动容灾切换备用线路 |
重试原则
- 400 / 401 / 403 / 大多数 404 是请求或权限问题,修正后再重试。
- 429 应降低并发并使用指数退避(如等待 1、2、4、8 秒后重试)。
- 500 / 502 / 网络超时 可有限重试,建议指数退避并限制总次数。
- 503 为上游临时故障:等待后重试通常有效;也可切换到同分组其他模型继续工作。
- 501 表示功能不受支持,应调整请求或选择其他模型,而不是重试相同请求。
反馈问题
请提供:请求时间、HTTP 状态码、请求路径、模型名和响应中的请求 ID(如有)。不要提供 API Key。