入门指南
调试错误
当您发送请求时，通常会从服务器获得带有预期响应体的 200 OK 响应。 如果您的请求或我们的服务出现错误，API 端点通常会返回带有错误信息的错误代码。
NOTE
如果有持续的服务中断，您可以访问 https://status.x.ai 获取最新更新。状态信息也可通过 RSS 在 https://status.x.ai/feed.xml 获取。
本站点的导航栏中也显示了服务状态。
大多数错误都会附带自解释的错误信息。有关每个端点的典型状态代码，请访问 API 参考。
状态代码
以下是按状态代码排列的潜在错误和状态列表。
4XX 状态代码
| 状态 | 端点 | 原因 | 解决方案 |
|---|---|---|---|
| 400Bad Request | 所有端点 | 检查您的请求正文或请求 URL。 | |
| 401Unauthorized | 所有端点 | 未提供授权头或提供了无效的授权令牌。 | 提供 Authorization: Bearer <XAI_API_KEY> 头。您可以在 xAI Console 获取新的 API 密钥。 |
| 403Forbidden | 所有端点 | 请向您的团队管理员请求权限。 | |
| 404Not Found | 所有端点 | 对照 API 参考 检查您的请求正文和端点 URL。 | |
| 405Method Not Allowed | 所有端点 | 请求方法不被允许。例如，向仅支持 GET 的端点发送 POST 请求。 | 对照 API 参考 检查您的请求方法。 |
| 415Unsupported Media Type | 支持 POST 的端点 | ||
| 422Unprocessable Entity | 支持 POST 的端点 | POST 请求正文中的某个字段格式无效。 | 对照 API 参考 检查您的请求正文。 |
| 429Too Many Requests | 推理端点 | 您发送请求过于频繁，已达到速率限制。 | 降低您的请求速率或在 xAI Console 提高您的速率限制。 |
2XX 状态代码
| 状态 | 端点 | 原因 | 解决方案 |
|---|---|---|---|
| 202Accepted | /v1/chat/deferred-completion/{request_id} | 您的延迟聊天完成请求已排队处理，但响应尚未可用。 | 等待请求完成处理。 |
错误报告
如果您认为自己遇到了错误并希望为我们的开发过程做出贡献，请将您的 API 请求和响应以及相关日志通过 邮件发送 API 错误报告 至 support@x.ai。
您也可以在我们的 xAI API 开发者 Discord 的 #help 频道中进行聊天。