Перейти к содержанию

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

POST /anthropic/subscription/api/v1/messages создает сообщение через подписку Claude либо вызывает модель другого провайдера за счет баланса хаба. Поля описаны в документации Anthropic Messages.

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

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. Фрагмент ответа:

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

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

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

Ключ хаба передается только в x-coreinfra-api-key. Для вызова по подписке дополнительно нужен ее токен в Authorization: Bearer; x-api-key не заменяет ключ хаба. Настройка клиента описана в разделе «Подписка Claude».

Модель другого провайдера, для которой есть текстовый протокол, отличный от Anthropic Messages, вызывается через конвертацию за счет хаба. Модели Anthropic, неизвестные хабу id и модели только с Messages направляются в подписку. Псевдонимы из каталога подписки распознаются хабом.

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

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

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

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

Запрос конвертируется в протокол выбранной модели и возвращается в формате Messages по правилам конвертации Messages. Токен подписки для этой ветки не требуется.

Сам вызов по подписке не резервирует и не списывает средства хаба. Если включено «Скрытие моделями», выполненная проверка персональных данных оплачивается отдельно с баланса хаба. Вызов модели другого провайдера резервируется и оплачивается за токены по ее usage; правила описаны на странице «Стоимость генеративных моделей», цены — на «Тарифах».

Ошибки​

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

Формат ошибок приведен в разделе Anthropic API; общие ошибки ключа хаба и баланса описаны в общем справочнике.