错误码
遇到错误时优先检查 HTTP 状态码与响应 body 中的 error 字段
HTTP 状态码
| HTTP 状态码 | 错误类型 | 说明 |
|---|---|---|
| 401 | Unauthorized | API Key 无效或未传 |
| 402 | Payment Required | 账户余额不足，请充值 |
| 403 | Forbidden | 该 token 没有该模型/分组的访问权限 |
| 429 | Too Many Requests | 请求频率超出限制，稍后重试 |
| 500 | Server Error | 服务器内部错误，请稍后重试 |
| 503 | Service Unavailable | 上游服务暂时不可用 |
错误响应格式
{
"error": {
"message": "Incorrect API key provided",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}
常见错误处理
| 现象 | 原因 | 解决 |
|---|---|---|
| 401 unauthorized | API Key 错 / 未传 Bearer 前缀 | 检查 Header 格式 Authorization: Bearer sk-... |
| 403 调用视频模型 | token 不在 vip 分组 | 登录控制台 → 令牌 → 编辑 → 改分组为 vip |
| 402 余额不足 | 账户余额或 token 额度耗尽 | 控制台 → 充值，或为 token 增加额度 |
| 429 频率限制 | 触发 rate limit | 降低请求并发；或联系客服调高限额 |