Claude Sonnet 5.5 через API: подключение, цены и кэш на 18 октября 2026

Как вызвать claude-sonnet-5-5 из Python и curl, сколько стоит типичный запрос с кэшем и без и чем модель отличается от Sonnet 5 и Sonnet 4.6.

6 мин · · модели · API-ключи

Claude Sonnet API в Zukko это модель claude-sonnet-5-5 за $0.4 на вход и $2 на выход за миллион токенов (цены на 18 октября 2026). Её можно вызвать и в Anthropic-формате, и в OpenAI-формате с одним ключом fetch_.... Ниже: параметры модели, два способа подключения, расчёт стоимости типичного запроса с кэшем и без него и сравнение с соседними версиями Sonnet по цене и индексу силы.

Claude Sonnet API: параметры и цены

Цены Zukko, $ за 1M токенов. Кэш тарифицируется отдельно. Индекс силы это Intelligence Index от Artificial Analysis.

МодельВход / выходКэш чтение / записьОфициально вход / выходКонтекстИндекс
claude-sonnet-5-50.4 / 20.05 / 0.52 / 101M48
claude-sonnet-50.4 / 20.05 / 0.52 / 101M45
claude-sonnet-4-60.5 / 2.50.063 / 0.63 / 151M42
claude-opus-5-50.8 / 40.08 / 14 / 201M58

Все четыре модели принимают изображения на вход. Актуальный список и цены всегда доступны через GET https://api.zukko.pro/v1/models и на странице «Модели» в кабинете: поставщики меняют цены, и таблица верна на дату статьи.

Подключение в Anthropic-формате

Это основной путь для Claude: так работает официальный Anthropic SDK, Claude Code и другие клиенты на этом формате. Важная деталь: base URL без /v1, SDK добавляет путь сам.

bash
import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.zukko.pro",
    api_key=os.environ["ZUKKO_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Объясни разницу между mutex и semaphore"}],
)
print(msg.content[0].text)
print(msg.usage)

То же через curl, если нужен минимальный тест ключа:

bash
curl https://api.zukko.pro/v1/messages \
  -H "x-api-key: $ZUKKO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,
       "messages":[{"role":"user","content":"Привет"}]}'

Формат запроса описан в справке по messages.

Подключение в OpenAI-формате

Если ваш код или инструмент уже работает через OpenAI SDK, достаточно сменить адрес и имя модели. Base URL здесь с /v1.

bash
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key=os.environ["ZUKKO_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Объясни разницу между mutex и semaphore"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

У этого формата есть один нюанс, касающийся кэша, о нём следующий раздел.

Кэш: где скидка есть, а где нет

Кэш промптов у Claude оплачивается отдельными ценами: чтение дешевле входа (0.05 против 0.4), запись дороже (0.5 против 0.4). Скидку за кэш даёт Anthropic-формат (/v1/messages, Anthropic SDK, Claude Code): там шлюз видит, сколько входа пришло из кэша. В OpenAI-формате для Claude весь вход идёт по цене входа. Если у вас длинный повторяющийся префикс (системный промпт, документ, описание инструментов), для Claude выбирайте Anthropic-формат. Подробный разбор: Claude через messages или chat completions: что будет с кэшем.

Как включить кэш в запросе:

bash
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=512,
    system=[{"type": "text", "text": LONG_INSTRUCTIONS,
             "cache_control": {"type": "ephemeral"}}],
    messages=[{"role": "user", "content": question}],
)
u = msg.usage
cost = (u.input_tokens * 0.4
        + (u.cache_read_input_tokens or 0) * 0.05
        + (u.cache_creation_input_tokens or 0) * 0.5
        + u.output_tokens * 2) / 1_000_000
print(f"${cost:.5f}")

Формула в коде это ровно формула стоимости: свежий вход × цена входа + чтение кэша × цена чтения + запись кэша × цена записи + выход × цена выхода. Условия работы кэша (минимальная длина префикса, время жизни) задаёт Anthropic: смотрите их документацию, мы эти параметры здесь не фиксируем.

Сколько стоит типичный запрос

Допущения: запрос с 20 000 токенов входа, из которых 18 000 токенов это стабильный префикс (инструкции, документы), и 1 000 токенов выхода. Это пример для расчёта, свои значения измерьте по usage ответа или через POST /v1/messages/count_tokens. Формула: (свежий вход × цена входа + чтение кэша × цена чтения + запись кэша × цена записи + выход × цена выхода) / 1 000 000.

  • Без кэша (или OpenAI-формат): 20 000 × 0.4 / 1 000 000 + 1 000 × 2 / 1 000 000 = 0.008 + 0.002 = $0.010.
  • С кэшем, повторный запрос: свежий вход 2 000 × 0.4 / 1 000 000 = 0.0008; чтение 18 000 × 0.05 / 1 000 000 = 0.0009; выход 0.002. Итого $0.0037.
  • Первый запрос с записью кэша: 0.0008 (свежий вход) + 18 000 × 0.5 / 1 000 000 = 0.009 (запись) + 0.002 (выход) = $0.0118, то есть дороже обычного на 18 000 × (0.5 − 0.4) / 1 000 000 = $0.0018. Экономия на каждом чтении: 18 000 × (0.4 − 0.05) / 1 000 000 = $0.0063. Так что кэш окупается уже на первом повторе.
  • 1000 запросов подряд в течение жизни кэша: без кэша 1000 × 0.010 = $10.00; с кэшем 0.0118 + 999 × 0.0037 ≈ $3.71 (первый запрос с записью, остальные 999 с чтением). Если кэш по времени истекает, записей будет больше.

Для сравнения, тот же запрос без кэша по официальным ценам из таблицы (2 / 10): 20 000 × 2 / 1 000 000 + 1 000 × 10 / 1 000 000 = $0.05. Официальные цены кэша мы здесь не сравниваем, их надо смотреть у поставщика.

Sonnet 5.5, Sonnet 5 и Sonnet 4.6

На 18 октября 2026:

  • claude-sonnet-5-5 против claude-sonnet-5. Цены в Zukko одинаковые (0.4 / 2, кэш 0.05 / 0.5), контекст одинаковый, индекс 48 против 45. По цене причин брать старую версию нет, но поведение моделей отличается, поэтому для критичных промптов прогоните свой тестовый набор. Разбор пары по другой оси: Sonnet 5 или Opus 5.5.
  • claude-sonnet-4-6. Стоит дороже (0.5 / 2.5) при индексе 42. Её имеет смысл держать, если у вас есть оценённые на ней промпты и вы не готовы переоценивать, а не из-за цены.
  • claude-opus-5-5. Вдвое дороже Sonnet 5.5 (0.8 / 4), индекс 58. Тот же запрос из примера выше без кэша стоит $0.020, с кэшем $0.0070 (2 000 × 0.8 + 18 000 × 0.08 + 1 000 × 4, делённое на 1 000 000).

Индекс не говорит, какая модель лучше на вашей задаче: он усредняет чужие тесты. Возьмите 20 своих реальных запросов, прогоните на двух-трёх моделях и сравните результат с ценой.

Можно ли получить Claude Sonnet бесплатно

Бесплатного API для Claude Sonnet нет: каждый запрос тарифицируется по таблице выше, баланс пополняется от $1. Из приятных мелочей есть разовые $0.50 за подписку на Telegram-канал @zukkopro, один раз на Telegram-аккаунт. Модели Sonnet 4.5 в актуальной таблице моделей на 18 октября 2026 нет; доступные версии смотрите в GET /v1/models.

Ошибки при подключении

  • 401: ключ неверный или скопирован с пробелом.
  • 402: на балансе не хватает средств.
  • 403 model_not_allowed_for_key: у ключа ограничен список моделей (allowed_models).
  • 404 model_not_found: опечатка в имени модели. Проверьте claude-sonnet-5-5 с дефисами, а не с точкой.
  • 429: исчерпан дневной или месячный лимит ключа либо ограничение у поставщика модели.
  • 404 при обращении к /v1/v1/messages или /messages: перепутан base URL. Для Anthropic SDK адрес без /v1, для OpenAI SDK с ним.

Подключение

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

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

Сколько стоит Claude Sonnet через API?

Для claude-sonnet-5-5 в Zukko $0.4 за миллион токенов входа и $2 за миллион выхода на 18 октября 2026. Кэш: чтение $0.05, запись $0.5.

Какой формат выбрать для Sonnet?

Anthropic-формат, если важна скидка за кэш. OpenAI-формат, если код уже написан под OpenAI SDK и повторяющегося префикса нет.

Чем Sonnet 5.5 отличается от Sonnet 5?

Цена и контекст одинаковые, индекс силы 48 против 45. Остальные различия проверяйте на своих задачах.

Подходит ли Sonnet 5.5 для Claude Code?

Да, его можно указать в ANTHROPIC_MODEL. Для Claude Code base URL https://api.zukko.pro без /v1, токен в ANTHROPIC_AUTH_TOKEN. Подробности в документации по Claude Code.

zukko

Платите в 25×
меньше

за Claude Code & ChatGPT

Один ключ fetch_* и base URL api.zukko.pro — в Cursor, Claude Code, Codex и любом SDK.