Claude Sonnet 5 — модель линейки Sonnet, выпущенная Anthropic 30 июня 2026 года; её ключевые особенности — контекст в 1 000 000 токенов, адаптивное мышление и стабильность в агентных сценариях. Сначала о статусе: по состоянию на октябрь 2026 года актуальной моделью линейки Sonnet является Sonnet 5.5, а Sonnet 5 перешла в статус legacy, но остаётся доступной; заявленный срок вывода из эксплуатации — не ранее 30 июня 2027 года. Новым проектам стоит в первую очередь оценить Sonnet 5.5; командам, которые уже используют claude-sonnet-5, важно разобраться с ключами, контекстом и вызовами, чтобы не столкнуться с проблемами до миграции.

Ниже — статус и спецификации модели, получение ключа, вызовы Messages API, границы использования контекста 1M, кэш и контроль затрат, а также частые ошибки и ответы на вопросы.

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

1. Сначала уточните статус и спецификации

Параметр Официальная информация
ID модели claude-sonnet-5
Статус Legacy, доступна
Дата выпуска 30 июня 2026 года
Срок вывода Не ранее 30 июня 2027 года
Окно контекста 1 000 000 токенов
Максимальный выход 128 000 токенов (синхронный Messages API)
Пакетный выход 300 000 токенов (Batch API beta)
Вход/выход Текст, изображения → текст
Режим мышления Адаптивное мышление, effort по умолчанию high
Отсечение знаний Январь 2026 года

Несколько пунктов, которые легко понять неправильно:

  • «Legacy» не означает «отключена». Это значит, что появилась более новая модель, но старая всё ещё обслуживается.
  • 1M контекста — это ёмкость, а не цель. Чем длиннее контекст, тем выше стоимость входа и задержка.
  • Адаптивное мышление включено по умолчанию; для простых задач глубину можно снизить через effort.
  • Синхронный интерфейс ограничен выходом 128K; более длинный вывод доступен через бета-возможность Batch API.

Новым проектам с нуля стоит сразу оценивать Sonnet 5.5. Если промпты, наборы оценки и рабочий трафик уже построены вокруг Sonnet 5, сначала проведите сравнение на малой доле трафика и только затем решайте сроки миграции.

2. Получение ключа Claude API

Путь первый: Anthropic Console

  1. Зарегистрируйтесь и войдите в Anthropic Console, настройте организацию и биллинг.
  2. На странице API Keys создайте ключ и назовите его по проекту или среде.
  3. Убедитесь в наличии баланса, лимитов скорости и прав на модель.
  4. Поместите ключ в серверную переменную окружения; не добавляйте его во фронтенд или Git.

Официальный Base URL — https://api.anthropic.com, путь Messages — /v1/messages.

Путь второй: ZSQH AI Gateway

Зарегистрируйтесь в ZSQH AI Gateway, создайте ключ, пополните баланс и получите счета в юанях, а расход нескольких моделей смотрите в одной панели. Шлюз предоставляет Anthropic-совместимый вход с Base URL https://ai.zhongshangqihang.com; путь вызова также /v1/messages. Доступные модели Claude и правила заполнения имён смотрите в разделе тарифов.

Параметр Напрямую Anthropic Шлюз ZSQH
Base URL https://api.anthropic.com https://ai.zhongshangqihang.com
Заголовок авторизации x-api-key x-api-key
Заголовок версии anthropic-version: 2023-06-01 Такой же
Имя модели claude-sonnet-5 По странице тарифов
SDK Anthropic SDK Anthropic SDK

3. Вызов через curl

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

curl "https://ai.zhongshangqihang.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-5",
    "max_tokens": 800,
    "system": "Ты технический редактор; отвечай конкретно.",
    "messages": [
      {"role": "user", "content": "Тремя пунктами объясни границы использования контекста 1M."}
    ]
  }'

Обратите внимание на три момента: в Claude Messages API параметр max_tokens обязателен; авторизация идёт через x-api-key, а не Authorization: Bearer; заголовок anthropic-version нельзя опускать. Без любого из них вернётся 401 или 400.

4. Вызов через Python

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com",
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Ты помощник контроля качества поддержки; выводи только JSON.",
    messages=[
        {"role": "user", "content": "Определи тональность: доставка слишком медленная, но поддержка вежливая."}
    ],
)

print(msg.content[0].text)

Важное изменение совместимости: Sonnet 5 возвращает 400 при передаче нестандартных значений temperature, top_p и top_k. Если в старом коде привычно указано temperature=0.2, при переходе на Sonnet 5 это нужно убрать, а стабильность вывода регулировать промптом и effort.

5. Как выгодно использовать контекст 1M

1M токенов — это примерно 550 тысяч английских слов или 2,5 миллиона символов Unicode (оценка по текущему официальному токенизатору). Такой контекст подходит для сценариев «загрузить полный комплект материалов за один раз», но не для бездумной отправки всего подряд.

Сценарий Рекомендация Причина
Проверка длинного договора Загрузить весь текст, требовать JSON по пунктам Поиск может пропустить важный пункт
Вопросы по репозиторию кода Сначала найти релевантные файлы, затем собрать контекст Весь код дорог и рассеивает внимание
Многораундовая поддержка Хранить последние раунды плюс резюме истории Контроль роста входа
Массовый офлайн-анализ Использовать Batch API Для пакетной обработки есть отдельная скидка
Генерация длинного отчёта Генерировать по частям и объединять Избежать упора в предел одного выхода

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

6. Кэш и контроль затрат

Биллинг Claude состоит из входа, выхода, записи в кэш и чтения кэша. По официальной странице тарифов чтение кэша стоит примерно одну десятую цены входа, запись в 5-минутный кэш — примерно 1,25 цены входа, запись в часовой кэш — дороже; вход и выход Batch API считаются со скидкой 50%. Конкретные цены смотрите в разделе тарифов.

Стоимость запроса =
  некэшированные входные токены × цена входа
+ токены записи в кэш × цена записи
+ токены чтения кэша × цена чтения
+ выходные токены × цена выхода

Контроль затрат выполняйте в таком порядке:

  1. Стабильный префиксный кэш: system prompt, определения инструментов и фиксированную базу знаний ставьте в начало и добавляйте cache_control.
  2. Кэшируйте только повторно используемое: одноразовые документы не стоит записывать в кэш, иначе вы платите надбавку впустую.
  3. Сначала поиск, потом полный текст: 5–10 найденных фрагментов обычно дешевле, чем загрузка всей базы.
  4. Офлайн-задачи — в Batch: разметку, суммаризацию и классификацию без реального времени лучше обрабатывать пакетами.
  5. Настраивайте effort: для простых задач снижайте глубину мышления, для сложных — повышайте.
  6. Ограничивайте выход: задайте max_tokens и требуйте структурированный результат, чтобы сократить бесполезные длинные ответы.
  7. Разделяйте ключи по проектам: задайте лимиты и оповещения, еженедельно смотрите рейтинг расходов.

7. Частые ошибки

Ошибка Частая причина Действие
401 Unauthorized Неверный ключ, отсутствует x-api-key Скопируйте ключ заново, проверьте заголовки
404 Not Found Неверный Base URL или путь Убедитесь, что используется /v1/messages
400 invalid_request_error Передано нестандартное значение temperature и т. п. Уберите параметр и повторите
429 rate_limit_error Превышены параллельность или частота Снизьте параллельность, включите задержку
529 overloaded_error Высокая нагрузка на сервер Повторите позже, подготовьте резервный канал
invalid_request_error (prompt is too long) Вход превышает 1M Разбейте, примените поиск или суммаризацию
Ошибка, связанная с max_tokens Не заполнен или превышает предел Заполните по спецификации модели

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

Обязательно ли переходить с Sonnet 5 на Sonnet 5.5?

Принудительной миграции нет. Sonnet 5 всё ещё обслуживается, заявленный срок вывода — не ранее 30 июня 2027 года. Но новым проектам стоит оценить Sonnet 5.5; существующим — сначала сравнить на малой доле трафика и убедиться, что промпты, вызовы инструментов и формат вывода совместимы.

Один ли ключ для Claude API и подписки Claude?

Нет. Подписка относится к веб-версии и клиентским продуктам, API-ключ — учётные данные разработчика; биллинг и права управляются раздельно.

Станет ли работа с контекстом 1M дороже?

Да. За сам объём контекста отдельная «плата за ёмкость» не взимается, но чем больше входных токенов, тем выше счёт и задержка. Для длинных документов сначала применяйте поиск и суммаризацию; полный контекст нужен только там, где для решения необходим весь текст.

Поддерживает ли Sonnet 5 изображения на входе?

Да, официальная спецификация — текст и изображения на входе, текст на выходе. Изображения пересчитываются во входные токены; перед пакетной обработкой оцените стоимость.

Почему установка temperature возвращает 400?

Sonnet 5 не принимает нестандартные значения temperature, top_p и top_k. Уберите эти параметры и управляйте выводом промптом и effort.

Что дальше

Создайте тестовый ключ в ZSQH AI Gateway, выполните запрос Messages через curl, затем подключите Anthropic SDK. Доступность моделей и цены смотрите в разделе тарифов.

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