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

Настройка клиента или SDK Anthropic для работы через CoreInfra AI Hub, поддерживаемые операции и особенности конвертации.

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:

```bash
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](https://platform.claude.com/docs/en/api/messages/create). При работе через хаб действуют следующие отличия:

* Этот адрес 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](https://coreinfra.ru/docs/reference/anthropic.md).

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

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

| Метод         | Путь                        | Назначение и справочник                                                                           |
| ------------- | --------------------------- | ------------------------------------------------------------------------------------------------- |
| `GET`         | `/v1/models`                | [Список моделей](https://coreinfra.ru/docs/reference/anthropic/models.md)                         |
| `POST`        | `/v1/messages`              | [Генерация ответа](https://coreinfra.ru/docs/reference/anthropic/messages.md)                     |
| `POST`        | `/v1/messages/count_tokens` | [Подсчет входных токенов](https://coreinfra.ru/docs/reference/anthropic/messages-count_tokens.md) |
| `GET`, `HEAD` | `/api/hello`                | [Проверка соединения для Claude Code](https://coreinfra.ru/docs/reference/anthropic/api-hello.md) |

Список `GET /v1/models` возвращает генеративные модели с исходными идентификаторами, для которых доступен подсчет токенов. Полный перечень моделей, доступных в `POST /v1/messages`, приведен в [каталоге моделей](https://coreinfra.ru/docs/catalog.md), цены — на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

Для [Claude Code](https://coreinfra.ru/docs/claude-code.md) и [Claude Desktop](https://coreinfra.ru/docs/claude-desktop.md) используйте адрес [бэкенда для Claude Code](https://coreinfra.ru/docs/use/claude.md).

## Ошибки

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