Anthropic API — интерфейс моделей, который предоставляет Anthropic для вызова моделей семейства Claude. Многие путают «Anthropic API», «Claude API» и «Claude Code», хотя это разные уровни.

Статья объясняет, что такое Anthropic API, как его вызывать, чем он отличается от протокола OpenAI и какие есть два способа подключения из Китая.

Примечание: Anthropic и Claude — товарные знаки соответствующих правообладателей. Примеры отражают распространённую практику на октябрь 2026 года; интерфейсы и цены определяются официальными страницами и материалами сайта.

1. Связь трёх понятий

  • Anthropic: компания, разрабатывающая модели Claude.
  • Anthropic API / Claude API: интерфейс вызова моделей Claude, обычно означает Messages API.
  • Claude Code: инструмент Anthropic для программирования в командной строке, который внутри вызывает модель через API.

Поэтому в разных документах «Anthropic API» и «Claude API» используются как синонимы; в большинстве случаев речь об одном и том же интерфейсе моделей.

2. Особенности Anthropic API

2.1. Messages API

Основной интерфейс — POST /v1/messages. Тело запроса содержит:

  • model
  • max_tokens
  • messages
  • system (необязательно)
  • temperature, top_p и другие (необязательно)
  • tools (необязательно)

2.2. Заголовки запроса

Нативный интерфейс обычно требует:

x-api-key: sk-...
anthropic-version: 2023-06-01
content-type: application/json

Разные версии и шлюзы могут поддерживать Bearer Token; точные требования — в документации.

2.3. Уровни моделей

Распространённые уровни Claude:

Уровень Подходящие сценарии
Opus Сложные рассуждения, длинные агентские цепочки, трудные задачи
Sonnet Повседневная разработка, исправление ошибок, код-ревью
Haiku Простые задачи, пакетная обработка, низкая стоимость

Актуальные имена моделей и цены — на странице цены на модели.

3. Пример прямого вызова

export ANTHROPIC_API_KEY="sk-ваш-ключ"

curl "https://api.anthropic.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Объясни в трёх предложениях Messages API"}
    ]
  }'

Если используете SDK, инициализируйте его по официальной документации Anthropic SDK и не применяйте формат запросов OpenAI SDK.

4. Отличия Anthropic API от OpenAI API

Критерий Anthropic API OpenAI API
Основной путь /v1/messages /v1/chat/completions
Заголовок аутентификации x-api-key Authorization: Bearer
Заголовок версии anthropic-version Нет
Формат сообщений messages + system messages (включая роль system)
Вызов инструментов tools tools / functions
SDK Anthropic SDK OpenAI SDK

Они несовместимы напрямую. Многие шлюзы предоставляют оба входа: совместимый с Anthropic — для Claude Code, совместимый с OpenAI — для OpenAI SDK и инструментов.

5. Два способа подключения из Китая

Способ A: прямое официальное подключение

Base URL: https://api.anthropic.com

Подходит командам со стабильным доступом к Anthropic, официальным аккаунтом и способом оплаты.

Способ B: ZSQH AI Gateway

  • Вход, совместимый с Anthropic: https://ai.zhongshangqihang.com (для Claude Code и подобных инструментов)
  • Вход, совместимый с OpenAI: https://ai.zhongshangqihang.com/v1 (для OpenAI SDK и инструментов)

Зарегистрируйтесь в ZSQH AI Gateway, создайте ключ и пополните баланс. Имена моделей — на странице цены на модели.

6. Вызов Claude через OpenAI SDK

Если ваш инструмент поддерживает только протокол OpenAI, используйте вход шлюза, совместимый с OpenAI:

from openai import OpenAI

client = OpenAI(
    api_key="sk-ваш-ключ",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Ответь только OK"}],
)
print(resp.choices[0].message.content)

Обратите внимание: это не нативный протокол Anthropic, поэтому параметры и возможности могут различаться. Если нужны нативные вызовы инструментов и кэширование, используйте вход, совместимый с Anthropic.

7. Как понимать биллинг

Anthropic API обычно оплачивается по входным токенам, выходным токенам и кэшу. Учитывайте:

  • выходные токены обычно дороже входных;
  • длинный контекст увеличивает число входных токенов;
  • попадание в кэш экономит деньги, но происходит не для всех запросов;
  • уровни Opus/Sonnet/Haiku существенно различаются по цене.

Конкретные цены — на странице цены на модели. Метод оценки — в статье Claude Code: подписка или оплата API по токенам (2026).

8. Частые вопросы

Anthropic API и Claude API — это одно и то же?

В большинстве контекстов это один и тот же интерфейс моделей, различаются только названия.

Поддерживает ли Anthropic API формат OpenAI?

Нативно — нет. Нужен вход шлюза, совместимый с OpenAI, или слой адаптации.

Как обеспечить стабильный вызов из Китая?

Можно использовать прямое официальное подключение (если сеть позволяет) или шлюз, доступный из Китая. Учитывайте комплаенс данных и условия обслуживания.

Какой интерфейс использует Claude Code?

Claude Code работает через Anthropic Messages API; конкретная конфигурация — в статье Подключение Claude Code: ключ и первый запрос.

Что дальше

Если нужны стабильный доступ из Китая, единый счёт или переключение между моделями, зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ и выполните первый запрос Messages. Модели и цены — на странице цены на модели.

Читайте также: