# POST messages — xAI

Anthropic Messages по адресу API xai, политика полей и конвертация моделей.

`POST /xai/api/v1/messages` создает сообщение в формате Anthropic Messages для текстовых моделей хаба; для Grok используется конвертация. Поля протокола описаны в [документации Anthropic Messages](https://platform.claude.com/docs/en/api/http/messages); общий справочник — в [документации xAI](https://docs.x.ai/developers/rest-api-reference/inference).

```bash
curl https://hub.coreinfra.ai/xai/api/v1/messages \
  -H "x-api-key: $COREINFRA_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{"model":"claude-haiku-4-5-20251001","max_tokens":64,"messages":[{"role":"user","content":"2 + 2"}]}'
```

Ожидаемый текст — `4`. Фрагмент ответа:

```json
{"content":[{"type":"text","text":"4"}]}
```

## Отличия от API xAI

Для `/xai/api/v1/messages` действуют те же [правила и ограничения Anthropic Messages](https://coreinfra.ru/docs/reference/anthropic/messages.md#differences), что и на адресе `/anthropic/api/v1/messages`:

* Поля `metadata.user_id`, `speed`, `inference_geo`, бета-флаг `fast-mode-2026-02-01` в `anthropic-beta` и заголовок `x-grok-model-override` игнорируются.
* Поле `container`, встроенные инструменты `code_execution*`, ссылки на внешние ресурсы для изображений и документов и `file_id` отклоняются со статус-кодом `400`.
* Для моделей Grok (и других моделей без нативного протокола Messages) запрос конвертируется на стороне хаба, а ответ возвращается в формате Anthropic Messages.

### Оплата

До отправки хаб резервирует средства по оценке запроса, затем рассчитывает стоимость по `usage` модели, включая кэш и рассуждения. Веб-поиск оплачивается отдельно. Конвертация учитывается в протоколе, в котором модель выполнила запрос. Правила резерва и расчета — на странице [«Стоимость генеративных моделей»](https://coreinfra.ru/docs/billing/text.md), цены — на [«Тарифах»](https://hub.coreinfra.ai/pricing).

## Ошибки

* `400` — запрещенная возможность, неподходящий формат вложения или структурно некорректный запрос при конвертации.
* `502` — ошибка на стороне провайдера модели при выполнении запроса. Если ошибка возникла уже внутри SSE, поток завершается событием ошибки.

Формат ошибок приведен в [разделе xAI API](https://coreinfra.ru/docs/reference/xai.md#errors); общие ошибки ключа, выбора модели и баланса описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors), ограничения — в разделе [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
