# Anthropic API

API методы и общие правила Anthropic-совместимого API хаба.

Хаб принимает запросы Anthropic Messages и возвращает ответы в этом протоколе. Поля протокола описаны в [документации Anthropic](https://platform.claude.com/docs/en/api/overview).

Базовый адрес: `https://hub.coreinfra.ai/anthropic/api/v1`. Для подписки Claude: `https://hub.coreinfra.ai/anthropic/subscription/api/v1`.

## API методы

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

## Общие правила

Для Messages и подсчета токенов передавайте ключ хаба в `x-api-key` или `Authorization: Bearer`. Если передан `x-api-key`, используется он. Для API методов подписки ключ хаба передается в `x-coreinfra-api-key`, а токен подписки — в `Authorization: Bearer`. Каталоги и `hello` доступны без ключа.

При `stream: true` Messages возвращает SSE с событиями Anthropic Messages. Подсчет токенов и каталоги возвращают обычный JSON. `OPTIONS` возвращает статус-код `204` и обслуживает CORS preflight без вызова модели.

## Ошибки

Ошибки имеют формат Anthropic Messages:

```json
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid request"
  }
}
```

В потоке SSE событие ошибки передается с `event: error` и тем же JSON-объектом в `data:`. Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors).
