# POST messages — Anthropic

Переопределение полей, ограничения и конвертация Anthropic Messages в хабе.

`POST /anthropic/api/v1/messages` создает сообщение для текстовой генеративной модели: напрямую или с конвертацией в другой протокол. Поля запроса и ответа описаны в [документации Anthropic Messages](https://platform.claude.com/docs/en/api/http/messages).

```bash
curl https://hub.coreinfra.ai/anthropic/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 Anthropic

### Поля и возможности

Поля `metadata.user_id`, `speed` и `inference_geo` игнорируются; запросы к моделям Anthropic выполняются в стандартном режиме обслуживания (`standard_only`).

Бета-флаг `fast-mode-2026-02-01` в заголовке `anthropic-beta` и заголовок `x-grok-model-override` игнорируются: модель выбирается полем `model` в теле запроса.

Поле `container` и встроенные инструменты с `type`, начинающимся на `code_execution`, отклоняются со статус-кодом `400`. Изображения и документы передаются в кодировке base64 (или текстом в `document`). Ссылки на внешние ресурсы и `file_id` отклоняются со статус-кодом `400`, в том числе внутри результатов инструментов.

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

Когда выбранная модель не поддерживает Anthropic Messages напрямую, хаб конвертирует запрос и возвращает ответ в формате Anthropic Messages (включая SSE):

* Не конвертируются `top_k`, `context_management`, `safeguards`, `speed`, `inference_geo`, `cache_control` верхнего уровня, `container`, `thinking.budget_tokens`, `thinking.block_binding` и `messages[].output_config`.
* Текстовые блоки `system` объединяются в строку (без `citations` и `cache_control`). При конфликте `output_config.effort` имеет приоритет над `thinking`; если модель не поддерживает рассуждения, настройка рассуждений игнорируется.
* Конвертируются только пользовательские инструменты без `type` или с `type: "custom"` (без `cache_control`, `max_uses`, `eager_input_streaming`, `allowed_domains`, `blocked_domains` и `defer_loading`).
* В блоках содержимого не конвертируются `citations`, `context` у документов, `caller` у `tool_use`, а также блоки `redacted_thinking`, `server_tool_use` и `web_search_tool_result`.
* При конвертации в OpenAI Responses значение `max_tokens` ниже `16` повышается до `16`, а `stop_sequences` не конвертируется.

### Оплата

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

## Ошибки

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

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