发送请求时，通常会从 server 收到 200 OK response 以及预期的 response body。如果请求出错或服务发生错误，API endpoint 通常会返回 error code 和 error message。

大多数错误都会附带含义明确的 error message。有关各 endpoint 的常见 status code，请参阅 API Reference。

Status Code

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

状态	Endpoint	原因	解决方案
400Bad Request	所有 endpoint		检查 request body 或 request URL。
401Unauthorized	所有 endpoint	未提供 authorization header，或 authorization token 无效。	请提供 `Authorization: Bearer <XAI_API_KEY>` header。可以在 xAI Console。
403Forbidden	所有 endpoint		请向 team admin 申请权限。
404Not Found	所有 endpoint		对照 API Reference。
405Method Not Allowed	所有 endpoint	不允许使用该 request method。例如，将 `POST` 请求发送到仅支持 `GET`。	请对照 API Reference。
415Unsupported Media Type	支持 `POST`
422Unprocessable Entity	支持 `POST`	在 `POST` request body 中，有字段格式无效。	请对照 API Reference。
429Too Many Requests	Inference endpoint	发送请求过于频繁，已达到 rate limit。	请降低请求速率，或在 xAI Console。

状态	Endpoint	原因	解决方案
202Accepted	`/v1/chat/deferred-completion/{request_id}`	Deferred chat completion 请求已排队等待处理，但 response 尚不可用。	等待请求处理完成。

Bug 报告

如果你认为遇到了 bug，并希望帮助我们改进开发流程，请发送 API Bug Report 邮件至 support@x.ai，并附上 API request、response 和相关日志。

你也可以前往 #help channel，它位于 xAI API Developer Discord。