发送请求时，通常会从服务器收到 200 OK 响应以及预期的响应体。如果请求出错或服务发生错误，API endpoint 通常会返回错误码和错误消息。

大多数错误都会附带含义明确的错误消息。有关各 endpoint 的常见状态码，请参阅 API 参考。

状态码

以下按状态码列出可能的错误和状态。

状态	Endpoint	原因	解决方案
400错误请求	所有 endpoint		检查请求正文或请求 URL。
401未授权	所有 endpoint	未提供授权请求头，或授权 token 无效。	请提供 `Authorization: Bearer <XAI_API_KEY>` 请求头。可以在 xAI Console。
403禁止访问	所有 endpoint		请向团队管理员申请权限。
404未找到	所有 endpoint		请对照 API 参考。
405不允许的方法	所有 endpoint	不允许使用该请求方法。例如，将 `POST` 请求发送到仅支持 `GET`。	请对照 API 参考。
415不支持的媒体类型	支持 `POST`
422无法处理的实体	支持 `POST`	在 `POST` 请求正文中，有字段格式无效。	请对照 API 参考。
429请求过多	推理 endpoint	发送请求过于频繁，已达到速率限制。	请降低请求速率，或在 xAI Console。

状态	Endpoint	原因	解决方案
202已接受	`/v1/chat/deferred-completion/{request_id}`	延迟聊天补全请求已排队等待处理，但响应尚不可用。	等待请求处理完成。

错误报告

如果你认为遇到了错误，并希望帮助我们改进开发流程，请发送 API 错误报告邮件至 support@x.ai，并附上 API 请求、响应和相关日志。

你也可以前往 #help 频道，它位于我们的 xAI API Developer Discord。

最后更新：2026 年 5 月 13 日