# POST messages — подписка Claude

Выбор между подпиской Claude и моделью хаба по адресу API подписки Claude.

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

Минимальный запрос к публичной модели хаба через этот API метод:

```bash
curl https://hub.coreinfra.ai/anthropic/subscription/api/v1/messages \
  -H "x-coreinfra-api-key: $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"deepseek-flash","max_tokens":64,"messages":[{"role":"user","content":"2 + 2"}]}'
```

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

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

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

### Авторизация и выбор модели

Ключ хаба передается только в `x-coreinfra-api-key`. Для вызова по подписке дополнительно нужен ее токен в `Authorization: Bearer`; `x-api-key` не заменяет ключ хаба. Настройка клиента описана в разделе [«Подписка Claude»](https://coreinfra.ru/docs/claude-subscription.md).

Модель другого провайдера, для которой есть текстовый протокол, отличный от Anthropic Messages, вызывается через конвертацию за счет хаба. Модели Anthropic, неизвестные хабу id и модели только с Messages направляются в подписку. Псевдонимы из [каталога подписки](https://coreinfra.ru/docs/reference/anthropic/subscription-models.md) распознаются хабом.

### Запрос по подписке

Поле `inference_geo` игнорируется. Смена провайдера модели посередине сессии не поддерживается.

Политика вложений сохраняется: ссылки на внешние ресурсы для изображений и документов и `file_id` отклоняются со статус-кодом `400`. Изображения передаются в кодировке base64.

### Запрос к модели хаба

Запрос конвертируется в протокол выбранной модели и возвращается в формате Messages по [правилам конвертации Messages](https://coreinfra.ru/docs/reference/anthropic/messages.md#differences). Токен подписки для этой ветки не требуется.

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

## Ошибки

* `401` — для ветки подписки отсутствует пригодный `Authorization: Bearer`.
* `400` — неподходящее вложение или структурно некорректный запрос при конвертации.
* `502` — ошибка на стороне провайдера модели при выполнении запроса. После начала SSE ошибка передается событием потока.

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