附录
错误码说明
API 调用过程中可能遇到的错误码及其含义
HTTP 状态码
| 状态码 | 含义 | 说明 |
|---|---|---|
| 200 | OK | 请求成功 |
| 400 | Bad Request | 请求参数错误 |
| 401 | Unauthorized | 认证失败 |
| 403 | Forbidden | 权限不足或额度不足 |
| 404 | Not Found | 模型不存在或接口不存在 |
| 429 | Too Many Requests | 请求频率超限 |
| 500 | Internal Server Error | 服务器内部错误 |
| 502 | Bad Gateway | 上游服务错误 |
| 503 | Service Unavailable | 服务暂时不可用 |
API 错误码
认证相关
| 错误码 | 错误信息 | 说明 | 解决方法 |
|---|---|---|---|
invalid_api_key | Invalid API key | API Key 无效或已过期 | 检查 API Key 是否正确 |
missing_authorization | Missing authorization header | 缺少认证头 | 添加 Authorization 头 |
invalid_authorization | Invalid authorization format | 认证格式错误 | 确保格式为 Bearer sk-xxx |
请求参数相关
| 错误码 | 错误信息 | 说明 | 解决方法 |
|---|---|---|---|
invalid_request_error | Invalid request parameters | 请求参数错误 | 检查参数格式和类型 |
model_not_found | The model does not exist | 模型不存在 | 使用正确的模型 ID |
context_length_exceeded | Context length exceeded | 上下文长度超限 | 减少输入文本或选择更大上下文模型 |
invalid_model | Invalid model | 模型不可用 | 检查模型是否已启用 |
额度相关
| 错误码 | 错误信息 | 说明 | 解决方法 |
|---|---|---|---|
insufficient_quota | Insufficient quota | 额度不足 | 充值额度或联系客服 |
token_limit_exceeded | Token limit exceeded | Token 限制超限 | 减少输入或输出 token 数 |
频率限制相关
| 错误码 | 错误信息 | 说明 | 解决方法 |
|---|---|---|---|
rate_limit_exceeded | Rate limit exceeded | 请求频率超限 | 降低请求频率或联系客服提高限制 |
too_many_requests | Too many requests | 请求过多 | 稍后重试 |
服务器相关
| 错误码 | 错误信息 | 说明 | 解决方法 |
|---|---|---|---|
internal_server_error | Internal server error | 服务器内部错误 | 稍后重试或联系客服 |
bad_gateway | Bad gateway | 上游服务错误 | 稍后重试 |
service_unavailable | Service unavailable | 服务暂时不可用 | 稍后重试 |
gateway_timeout | Gateway timeout | 网关超时 | 稍后重试 |
错误响应格式
JSON 格式错误响应
{
"error": {
"message": "Invalid API key",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}错误响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
error.message | string | 错误描述信息 |
error.type | string | 错误类型 |
error.param | string/null | 错误相关的参数 |
error.code | string | 错误代码 |
常见问题
Q: 收到 401 错误怎么办？
- 检查 API Key 是否正确复制（包括
sk-前缀） - 确认 API Key 没有过期或被禁用
- 检查请求头格式是否为
Authorization: Bearer sk-your-api-key
Q: 收到 429 错误怎么办？
- 降低请求频率
- 联系客服提高频率限制
- 实现重试机制，使用指数退避策略
Q: 收到 500 错误怎么办？
- 稍后重试
- 检查服务状态页面
- 如果问题持续，联系客服
Q: 模型不可用怎么办？
- 确认模型 ID 拼写正确
- 检查模型是否在支持的模型列表中
- 如果模型不在列表中，请联系客服添加