# POST responses — xAI

Поля и возможности Responses, которые хаб изменяет или ограничивает по адресу API xai.

`POST /xai/api/v1/responses` создает ответ OpenAI Responses для текстовой модели хаба, напрямую или через конвертацию. Поля описаны в [документации xAI Responses](https://docs.x.ai/developers/rest-api-reference/inference/responses).

```bash
curl https://hub.coreinfra.ai/xai/api/v1/responses \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"grok-build-0.1","input":"2 + 2"}'
```

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

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

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

### Поддерживаемые возможности

Поле `inference_geo` и заголовок `x-grok-model-override` игнорируются; модель выбирается полем `model` в теле запроса. При вызове моделей xAI отключено сохранение (`store: false`) и игнорируются `user`, `safety_identifier` и `service_tier`. При вызове моделей OpenAI отключено сохранение (`store: false`), игнорируется `safety_identifier`, а из `service_tier` поддерживаются `auto`, `default`, `priority`, `fast` и `ultrafast`; у DeepSeek игнорируются `user`, `safety_identifier` и `service_tier`; у Moonshot AI игнорируются `user`, `safety_identifier`, `service_tier` и `prompt_cache_options`. Если выбранный `service_tier` не поддерживается тарифом модели, возвращается ошибка со статус-кодом `400`.

Со статус-кодом `400` отклоняются:

* `background: true`, значение `prompt` или `conversation`;
* MCP-инструмент с `tunnel_id`;
* инструменты `code_interpreter`, `file_search`, `image_generation`, `x_search`, `code_execution`, `collections_search`, `attachment_search`;
* `shell` с окружением `container_auto` или `container_reference`.

Проверка инструментов применяется также внутри `namespace` и элементов `additional_tools` / `tool_search_output` во входе. Локальный `shell` и пользовательские функции не запрещаются этим правилом.

Изображения принимаются только в кодировке base64 (`data:image/...;base64,...`). Ссылки на внешние ресурсы, `input_image.file_id`, `input_file.file_url` и `input_file.file_id` отклоняются со статус-кодом `400`, в том числе внутри результатов инструментов.

Когда в ответе модели Grok присутствуют данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле `usage.cost_rub`.

### При конвертации

Действуют те же [правила конвертации OpenAI Responses](https://coreinfra.ru/docs/reference/openai/responses.md#differences), что и на основном адресе OpenAI API: `previous_response_id`, `conversation` и `item_reference` отклоняются со статус-кодом `400`, а специфичные параметры без эквивалента в протоколе модели не конвертируются.

### Оплата

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

## Ошибки

* `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).
