常见错误码
| 状态码 | 错误 | 原因 | 解决方案 |
|---|---|---|---|
| 400 | Bad Request | 请求格式错误或参数无效 | 检查请求体格式和参数 |
| 401 | Unauthorized | API Key 无效或过期 | 检查 API Key 是否正确 |
| 403 | Forbidden | 账户无权限或被禁用 | 检查账户状态和权限 |
| 404 | Not Found | 请求的资源不存在 | 检查 URL 和资源 ID |
| 422 | Unprocessable Entity | Schema 验证失败 | 检查 JSON Schema 格式 |
| 429 | Too Many Requests | 超过速率限制 | 使用指数退避重试 |
| 500 | Internal Server Error | 服务器内部错误 | 重试请求，如持续联系支持 |
| 503 | Service Unavailable | 服务暂时不可用 | 等待后重试 |
推理模型错误
使用推理模型（如 grok-4.5）时的常见错误：
- 超时错误 — 推理模型可能需要更长时间。建议将超时设置为 3600 秒。
- 参数冲突 —
presencePenalty、frequencyPenalty和stop不能与推理模型一起使用。 - Schema 拒绝 — 检查 JSON Schema 是否包含不支持的特性。
超时设置
推理模型可能需要更长的响应时间。建议设置更长的超时：
# Python (xAI SDK)
client = Client(api_key=..., timeout=3600)
# Python (OpenAI)
client = OpenAI(api_key=..., base_url="https://api.x.ai/v1",
timeout=httpx.Timeout(3600.0))
# cURL
curl ... -m 3600 ...错误响应格式
错误响应包含 error 对象，提供详细的错误信息：
{
"error": {
"type": "invalid_request_error",
"message": "reasoning.effort is not supported for this model",
"code": "unsupported_parameter",
"param": "reasoning.effort"
}
}获取帮助
- Discord 社区 — 与其他开发者交流
- 邮件支持 — 发送邮件获取技术支持
- 官方文档 — 查看最新文档