# xAI API

API методы xAI-совместимого API хаба, форматы ответов и ошибок.

Хаб обслуживает OpenAI Responses, OpenAI Chat Completions и Anthropic Messages по адресу API `xai`. Поля API описаны в [документации xAI](https://docs.x.ai/developers/rest-api-reference/inference).

Базовый адрес: `https://hub.coreinfra.ai/xai/api/v1`.

## API методы

| Методы            | Путь                           | Назначение                                                                              |
| ----------------- | ------------------------------ | --------------------------------------------------------------------------------------- |
| `GET`, `OPTIONS`  | `/xai/api/v1/models`           | [Каталог моделей](https://coreinfra.ru/docs/reference/xai/models.md)                    |
| `GET`             | `/xai/api/v1/api-key`          | [Проверка запуска Grok Build](https://coreinfra.ru/docs/reference/xai/api-key.md)       |
| `POST`, `OPTIONS` | `/xai/api/v1/responses`        | [Создание ответа Responses](https://coreinfra.ru/docs/reference/xai/responses.md)       |
| `POST`, `OPTIONS` | `/xai/api/v1/chat/completions` | [Создание Chat Completion](https://coreinfra.ru/docs/reference/xai/chat-completions.md) |
| `POST`, `OPTIONS` | `/xai/api/v1/messages`         | [Создание сообщения Messages](https://coreinfra.ru/docs/reference/xai/messages.md)      |

## Общие правила

Для 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:

```json
{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid request",
    "param": null,
    "code": null
  }
}
```

Для `/xai/api/v1/messages` используется формат ошибок Anthropic Messages:

```json
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid request"
  }
}
```

Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors).
