错误码手册
HTTP 状态码
| HTTP | type | 含义 | 怎么处理 |
|---|---|---|---|
| 400 | invalid_request_error | 参数不合法 | 看 error.message |
| 401 | authentication_error | Key 缺失或无效 | 检查 Authorization 头 |
| 402 | insufficient_balance | 余额不足 | 控制台充值 |
| 403 | permission_denied | 无权限（如 Key 被禁用） | 检查 Key 状态 |
| 404 | model_not_found | 模型不存在或已下架 | GET /v1/models 查可用名 |
| 429 | rate_limit_exceeded | 触发限流 | 指数退避重试 |
| 502 | upstream_error | 上游供应商异常 | 换同模型其他供应商重试 |
| 504 | upstream_timeout | 上游超时 | 重试或换供应商 |
错误体格式
JSON
{"error": {"message": "模型不存在或已下线: xxx",
"type": "model_not_found",
"code": "model_not_found"}}排查顺序
- 看 HTTP 码定性（4xx 是你的问题，5xx 是我们的）
- 看 error.message 定位具体原因
- 401/402 查账务与 Key，404 查模型名，429 降并发
- 5xx 先重试一次，再换供应商；仍不行提工单附 X-Request-Id