入门
调试错误
当您发送请求时，通常会收到服务器返回的 200 OK 响应以及预期的响应正文。如果您的请求出现错误或我们的服务出现错误，API 端点通常会返回错误代码和错误消息。
如果服务正在中断，您可以访问 https://status.x.ai 获取最新更新。状态信息也通过 RSS 在 https://status.x.ai/feed.xml 提供。
服务状态也会显示在此网站的导航栏中。
大多数错误都会附带一条不言自明的错误消息。有关每个端点的典型状态代码，请访问 API 参考或查看我们的 OpenAPI 文档。
状态码
以下是按状态码排列的潜在错误和状态列表。
4XX 状态码
| 状态码 | 端点 | 原因 | 解决方案 |
|---|---|---|---|
| 400 错误请求 | 所有端点 | - POST 方法请求正文指定了无效参数，或者带有动态路由的 GET 方法的 URL 中包含无效参数。- 提供了不正确的 API 密钥。 | - 请检查您的请求正文或请求 URL。 |
| 401 未授权 | 所有端点 | - 未提供授权标头或提供了无效的授权令牌。 | - 在请求标头中提供 Authorization: Bearer Token <XAI_API_KEY>。您可以在 xAI 控制台上获取新的 API 密钥。 |
| 403 禁止 | 所有端点 | - 您的 API 密钥/团队没有执行此操作的权限。 - 您的 API 密钥/团队已被阻止。 | - 请向您的团队管理员请求权限。 |
| 404 未找到 | 所有端点 | - 在 POST 方法请求正文中指定的模型未找到。- 尝试访问无效的端点 URL。（URL 拼写错误） | - 请对照我们的 API 参考检查您的请求正文和端点 URL。 |
| 405 方法不被允许 | 所有端点 | - 请求方法不被允许。例如，向仅支持 GET 的端点发送 POST 请求。 | - 请对照我们的 API 参考检查您的请求方法。 |
| 415 不支持的媒体类型 | 所有支持 POST 方法的端点 | - POST 请求中请求正文为空。- 未指定 Content-Type: application/json 标头。 | - 添加有效的请求正文。 - 确保请求标头中存在 Content-Type: application/json 标头。 |
| 422 不可处理的实体 | 所有支持 POST 方法的端点 | - POST 请求正文中的某个字段格式无效。 | - 检查您的请求正文是否有效。您可以从 API 参考中找到更多信息。 |
| 429 请求过多 | 所有推理端点 | - 您发送请求过于频繁，已达到速率限制 | - 降低您的请求速率或提高您的速率限制。您可以在 xAI 控制台上查看您当前的速率限制。 |
2XX 错误码
| 状态码 | 端点 | 原因 | 解决方案 |
|---|---|---|---|
| 202 已接受 | /v1/chat/deferred-completion/{request_id} | - 您的延迟聊天补全请求已排队等待处理，但响应尚未可用。 | - 等待请求处理。 |
错误报告
如果您认为您遇到了 bug 并希望为我们的开发过程做出贡献，请发送API Bug 报告邮件至 support@x.ai，并附上您的 API 请求和响应以及相关日志。
您也可以在我们的 xAI API 开发者 Discord 的 #help 频道中聊天。