xAI API
Хаб обслуживает OpenAI Responses, OpenAI Chat Completions и Anthropic Messages по адресу API xai. Поля API описаны в документации xAI.
Базовый адрес: https://hub.coreinfra.ai/xai/api/v1.
API методы
| Методы | Путь | Назначение |
|---|---|---|
GET, OPTIONS | /xai/api/v1/models | Каталог моделей |
GET | /xai/api/v1/api-key | Проверка запуска Grok Build |
POST, OPTIONS | /xai/api/v1/responses | Создание ответа Responses |
POST, OPTIONS | /xai/api/v1/chat/completions | Создание Chat Completion |
POST, OPTIONS | /xai/api/v1/messages | Создание сообщения Messages |
Общие правила
Для Responses и Chat Completions передавайте ключ хаба в Authorization: Bearer. Для Messages также подходит x-api-key; при наличии обоих заголовков используется x-api-key. Каталог и api-key доступны без авторизации. Ответ api-key не проверяет пригодность ключа для генерации.
При stream: true возвращается SSE в протоколе вызванного API метода. Chat Completions использует кадры data:, Responses и Messages — именованные события своих протоколов. Каталог и api-key возвращают JSON. OPTIONS возвращает статус-код 204 без вызова модели.
Ошибки
Ошибки проверки запроса возвращаются в формате ошибок вызванного протокола — для Responses и Chat Completions:
{
"error": {
"type": "invalid_request_error",
"message": "Invalid request",
"param": null,
"code": null
}
}
Для /xai/api/v1/messages используется формат ошибок Anthropic Messages:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "Invalid request"
}
}
Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике.
