错误码
HTTP 状态码
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 200 | 成功 | — |
| 400 | 请求错误 | 检查请求参数 |
| 401 | 未授权 | 验证 API 密钥 |
| 403 | 禁止访问 | 检查账户权限 |
| 404 | 未找到 | 确认端点或模型 ID |
| 429 | 超出速率限制 | 降低请求频率或升级账户等级 |
| 500 | 服务器错误 | 稍作等待后重试 |
| 503 | 服务不可用 | 稍作等待后重试 |
错误类型
| 类型 | 说明 |
|---|---|
invalid_request_error | 请求格式错误或参数无效 |
authentication_error | API 密钥无效或缺失 |
rate_limit_error | 超出速率限制 |
model_not_found_error | 指定的模型不存在 |
context_length_exceeded | 输入超出模型的上下文窗口 |
content_filter_error | 内容被安全策略拦截 |
server_error | 服务器内部错误 |
错误响应格式
{
"error": {
"message": "Human-readable description",
"type": "error_type",
"code": "error_code",
"param": "parameter_name"
}
}常见错误
invalid_api_key
Status: 401
Message: "Invalid API key provided"请联系 support@linkwo.com 验证你的 API 密钥。
context_length_exceeded
Status: 400
Message: "This model's maximum context length is 128000 tokens"请减少输入长度，或使用 max_tokens 限制输出。
rate_limit_exceeded
Status: 429
Message: "Rate limit exceeded"请实现指数退避。详见速率限制。
model_not_found
Status: 404
Message: "Model 'gpt-5' not found"请在模型概览查看可用模型。