Claude API: что это и чем он отличается от чата claude.ai

Claude API — что это и чем отличается от чата на claude.ai? Чат — это готовое приложение, где вы пишете сообщения руками. API — это интерфейс, через который ваша программа отправляет запросы той же модели и получает ответы. Если вы хотите встроить Claude в бот, скрипт, сервис или редактор кода, нужен именно API. Ниже объясняем, как он устроен, и делаем первый запрос.

Чем API отличается от чата и подписки

Условия подписок на чат меняются, поэтому актуальный тариф смотрите на сайте самого сервиса. API же всегда считается по токенам: вы платите за то, что отправили и получили.

Сразу уточним: ключ API и подписка на чат оплачиваются отдельно, и ключ API не открывает доступ в приложение. При этом на странице цен Anthropic у части тарифов подписки указаны ежемесячные кредиты на API, так что что именно входит в ваш тариф, смотрите на сайте сервиса.

Как устроен Messages API

Основной способ работать с Claude — Messages API. Это один HTTP-запрос POST /v1/messages с JSON.

Главные поля:

• model — имя модели, например claude-sonnet-5-5;
• max_tokens — потолок длины ответа, поле обязательное;
• messages — список реплик с ролями user и assistant;
• system — системная инструкция (роль, правила);
• tools — описания инструментов, если модель должна вызывать функции.

Модель не помнит прошлых запросов: историю диалога вы каждый раз присылаете целиком. Это важно для стоимости, о чём ниже.

Через Zukko тот же формат доступен по адресу https://api.zukko.pro/v1/messages. Полное описание параметров есть в документации по Messages API↗.

Первый запрос на curl

Создайте ключ на странице API-ключей↗ (он начинается с fetch_), а затем:

curl https://api.zukko.pro/v1/messages \
  -H "x-api-key: fetch_ваш_ключ" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 300,
    "system": "Отвечай кратко, на русском.",
    "messages": [{"role": "user", "content": "Чем API отличается от чата?"}]
  }'

В ответе будет JSON: массив content с текстом и блок usage с числом входных и выходных токенов. Вместо x-api-key можно передать заголовок Authorization: Bearer fetch_ваш_ключ, оба варианта работают.

То же на Python

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.zukko.pro",   # без /v1: SDK сам добавляет путь
    api_key="fetch_ваш_ключ",
)

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=300,
    system="Отвечай кратко, на русском.",
    messages=[{"role": "user", "content": "Чем API отличается от чата?"}],
)

print(message.content[0].text)
print(message.usage.input_tokens, message.usage.output_tokens)

Адрес без /v1 — частая ловушка. Официальный Anthropic SDK дописывает /v1/messages сам, поэтому лишний /v1 в base URL приведёт к 404. Если вы используете OpenAI SDK, там наоборот: https://api.zukko.pro/v1. Как выбрать между форматами, объясняет статья base URL с /v1 или без↗.

Токены и цена

Токен — это кусок текста, примерно слог или короткое слово. Цена считается за миллион токенов отдельно для входа (всё, что вы отправили) и выхода (то, что написала модель).

Для claude-sonnet-5-5 на 18 октября 2026 цена в Zukko — $0.4 за 1M входа и $2 за 1M выхода (официальная — $2 и $10). Для запроса на 1 000 входных и 500 выходных токенов:

• Вход: 1 000 × 0.4 / 1 000 000 = $0.0004
• Выход: 500 × 2 / 1 000 000 = $0.001
• Итого: $0.0014

Актуальные цены всех моделей — на странице «Модели» кабинета и в GET https://api.zukko.pro/v1/models. Сколько токенов займёт запрос, можно узнать заранее через POST /v1/messages/count_tokens.

Кэш промптов

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

В Anthropic-формате блок помечается полем cache_control:

{
  "system": [
    {
      "type": "text",
      "text": "…длинная инструкция или документ…",
      "cache_control": {"type": "ephemeral"}
    }
  ]
}

Цены кэша для claude-sonnet-5-5: чтение $0.05 за 1M, запись $0.5 за 1M. Допустим, системный блок на 10 000 токенов используется в 100 запросах:

• Без кэша: 100 × 10 000 × 0.4 / 1 000 000 = $0.40
• С кэшем: запись 10 000 × 0.5 / 1 000 000 = $0.005, чтение 99 × 10 000 × 0.05 / 1 000 000 = $0.0495, итого $0.0545

Минимальный размер блока и время жизни кэша зависят от правил Anthropic: сверяйтесь с её документацией. И помните: скидку за кэш шлюз видит в Anthropic-формате. Если слать Claude через /v1/chat/completions, весь вход тарифицируется по цене входа. Подробный разбор: Claude через /v1/messages или chat/completions↗.

Инструменты (tool use)

Через параметр tools вы описываете функции, а модель решает, когда их вызвать. Она возвращает не текст, а блок tool_use с именем функции и аргументами; ваш код выполняет функцию и отправляет результат обратно в следующем запросе. Так строятся агенты и боты, которые ходят в базу или в сторонний API. Полный цикл на Python показан в статье tool use в Claude↗.

Кому нужен Claude API

• Разработчикам, которые встраивают модель в продукт.
• Командам, которые автоматизируют текстовую обработку: классификацию, суммаризацию, извлечение данных.
• Тем, кто использует консольные агенты и расширения для редакторов: Claude Code, Cline и другие подключаются по ключу API.

Если вам нужно только иногда задавать вопросы, проще чат. Для этого есть чат в браузере↗ на том же балансе.

Как получить доступ из России

Доступ из России — через шлюз Zukko. Баланс в долларах пополняется от $1: СБП (комиссия платёжной страницы 8,5% сверху), картой MasterCard или криптовалютой. Подписки нет: платите за токены.

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

Чем Claude API отличается от подписки на чат?

Подписка рассчитана на ручную работу в приложении. API рассчитан на программы и оплачивается за токены. Условия того, входят ли в ваш тариф подписки кредиты на API, смотрите на сайте сервиса.

Обязателен ли параметр max_tokens?

Да, в Messages API он обязателен. Он ограничивает длину ответа, а значит и верхнюю границу стоимости запроса.

Можно ли вызывать Claude через OpenAI SDK?

Да, любую модель каталога можно вызвать в любом формате. Но кэш для Claude виден шлюзу только в Anthropic-формате, поэтому для длинных повторяющихся контекстов лучше /v1/messages.

Где посмотреть расход?

В разделе «Использование» кабинета: там видна история расходов. Баланс и расходы доступны и через API.