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

Anthropic-совместимый API

Anthropic-совместимый API хаба позволяет вызывать модели Anthropic и других провайдеров через хаб без VPN по протоколу Anthropic Messages с оплатой по ключу хаба.

1. Настройте адрес и ключ​

Укажите в клиенте базовый адрес https://hub.coreinfra.ai/anthropic/api (для SDK, которые сами добавляют /v1/...) или https://hub.coreinfra.ai/anthropic/api/v1 и подставьте ключ хаба sk-ci2-... в заголовок x-api-key или Authorization: Bearer.

Проверьте запрос через cURL:

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

Ожидаемый текст ответа — 4.

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

Полное описание протокола приведено в документации Anthropic. При работе через хаб действуют следующие отличия:

  • Этот адрес API предоставляет Messages, подсчет токенов и каталог моделей. Message Batches и Files через него не обслуживаются.
  • Поля metadata.user_id, speed, inference_geo и бета-флаг fast-mode-2026-02-01 в заголовке anthropic-beta игнорируются; запросы к моделям Anthropic выполняются в стандартном режиме обслуживания (standard_only).
  • Поле container и встроенные инструменты с типом code_execution* не поддерживаются и отклоняются со статус-кодом 400.
  • Изображения и документы передавайте в кодировке base64 (или текстом в блоке document). Ссылки на внешние ресурсы и file_id отклоняются со статус-кодом 400.

Конвертация​

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

  • При конвертации не конвертируются top_k, context_management, safeguards, cache_control верхнего уровня, thinking.budget_tokens, citations и серверные блоки инструментов.
  • Из инструментов конвертируются пользовательские инструменты (custom или без type); встроенные инструменты провайдера пропускаются. Подробности приведены в справочнике Anthropic API.

Что доступно​

Доступны следующие API методы относительно https://hub.coreinfra.ai/anthropic/api:

МетодПутьНазначение и справочник
GET/v1/modelsСписок моделей
POST/v1/messagesГенерация ответа
POST/v1/messages/count_tokensПодсчет входных токенов
GET, HEAD/api/helloПроверка соединения для Claude Code

Список GET /v1/models возвращает генеративные модели с исходными идентификаторами, для которых доступен подсчет токенов. Полный перечень моделей, доступных в POST /v1/messages, приведен в каталоге моделей, цены — на странице «Тарифы».

Для Claude Code и Claude Desktop используйте адрес бэкенда для Claude Code.

Ошибки​

Формат и примеры ошибок Anthropic Messages приведены в справочнике Anthropic API. Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике API и на странице «Лимиты и ограничения».