Claude Sonnet API (2026): ID моделей, настройка, лимиты и код для Sonnet 5.5
Чтобы использовать Claude Sonnet API, создайте API-ключ Anthropic и отправьте запрос на https://api.anthropic.com/v1/messages с ID модели claude-sonnet-5-5 — это актуальная модель Sonnet, выпущенная 28 сентября 2026 года. У неё контекстное окно 1M токенов, до 128K токенов на выходе, адаптивное мышление включено по умолчанию, а стоимость по официальному прайсу Anthropic на 21 октября 2026 года составляет $2 за миллион входных и $10 за миллион выходных токенов. Если вы переносите код с Sonnet 4.6 или более ранних версий, пять параметров, которые раньше работали, теперь возвращают ошибку 400 — они перечислены ниже.
Это руководство для разработчиков, которые строят продукт на Claude: какой ID модели Sonnet вызывать, как получить ключ, рабочий код на curl, Python и Node.js, лимиты по уровням и несовместимые изменения, на которых чаще всего спотыкаются при миграции. Полный разбор стоимости всех моделей Claude — в нашем руководстве по ценам Claude API.
Модели Claude Sonnet, доступные через API
| Модель | ID модели в API | Статус (21 окт. 2026) | Контекст / макс. вывод | Вход / выход за 1M токенов | Чтение кэша |
|---|---|---|---|---|---|
| Claude Sonnet 5.5 | claude-sonnet-5-5 |
Актуальная, выпущена 28 сент. 2026 | 1M / 128K | $2 / $10 | $0.10 |
| Claude Sonnet 5 | claude-sonnet-5 |
Устаревшая (legacy) | см. документацию | $2 / $10 | $0.20 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
Устаревшая (legacy) | см. документацию | $3 / $15 | $0.30 |
| Claude Sonnet 4.5 | claude-sonnet-4-5-20250929 |
Объявлена к выводу, отключение 30 нояб. 2026 | см. документацию | $3 / $15 | $0.30 |
Цены — со страницы цен Anthropic; статус моделей — из обзора моделей и страницы выводимых моделей; характеристики Sonnet 5.5 — из обзора Sonnet 5.5; всё проверено 21 октября 2026 года.
Что вызывать: для новых проектов используйте claude-sonnet-5-5. По цене за токен она равна Sonnet 5, но чтение кэша вдвое дешевле ($0.10 против $0.20 за миллион), согласно руководству по миграции. По сравнению с Sonnet 4.6 ($3 / $15) Sonnet 5.5 дешевле за токен, но учитывайте токенизатор: по данным Anthropic, Sonnet 5.5 даёт примерно на 30% больше токенов, чем Sonnet 4.6, на том же тексте, поэтому сравнивайте реальное число токенов, а не только прайс. Пользователям Sonnet 4.5 нужно мигрировать до её отключения 30 ноября 2026 года.
Sonnet 5.5 кратко
| Параметр | Значение | Источник |
|---|---|---|
| ID модели (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS) | claude-sonnet-5-5 |
Обзор |
| ID модели в Amazon Bedrock | anthropic.claude-sonnet-5-5 |
Обзор |
| Контекстное окно | 1M токенов | Обзор |
| Максимальный вывод | 128K токенов; 300K в Batch API с бета-заголовком output-300k-2026-03-24 |
Обзор |
| Модальности | Текст и изображения на входе, текст на выходе | Обзор |
| Мышление | Адаптивное, включено по умолчанию; минимальный режим — between_tools |
Обзор |
| Effort по умолчанию | high |
Обзор |
| Граница знаний | Июнь 2026 | Обзор |
| Вывод из эксплуатации | Не ранее 28 сентября 2027 | Обзор |
Как получить API-ключ Claude Sonnet
- Войдите в Claude Console и откройте API keys.
- Создайте ключ, скопируйте его один раз и сохраните как
ANTHROPIC_API_KEYв переменных окружения или менеджере секретов. - Пополните баланс или добавьте способ оплаты. Уровень использования (и лимиты) растёт вместе с расходами — см. раздел о лимитах ниже.
Один ключ работает для всех моделей Claude, отдельного «ключа Sonnet API» не существует. Если вам нужен один ключ сразу для Claude, GPT, Gemini и DeepSeek, единый API вроде Flatkey выдаёт общий ключ для всех (подробнее в конце статьи).
Первый запрос к Claude Sonnet 5.5
Запрос ниже повторяет официальный пример Anthropic из руководства по миграции на Sonnet 5.5. В нём задан уровень effort и нет ни одного параметра, который возвращает 400 на этой модели.
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-5-5",
"max_tokens": 4096,
"messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
"output_config": {"effort": "medium"}
}'
Python с официальным SDK anthropic:
# pip install anthropic
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY
response = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
output_config={"effort": "medium"},
)
print("stop_reason:", response.stop_reason)
for block in response.content:
if block.type == "text": # adaptive thinking may add thinking blocks first
print(block.text)
Node.js с @anthropic-ai/sdk:
// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const response = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 4096,
messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
output_config: { effort: "medium" },
});
const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);
Читайте ответ по типу блока. При адаптивном мышлении первым блоком может оказаться блок thinking, поэтому response.content[0].text на Sonnet 5.5 использовать небезопасно.
Effort и мышление в Sonnet 5.5
Sonnet 5.5 заменяет фиксированные бюджеты мышления параметром effort в output_config (документация по effort). Значение по умолчанию — high. В руководстве по миграции Anthropic приведены уровни low, medium, high, xhigh и max.
| Задача | Что отправить | Примечания из документации Anthropic |
|---|---|---|
| Поведение по умолчанию | ничего или thinking: {"type": "adaptive"} |
Адаптивное мышление включено по умолчанию |
| Дешевле и быстрее | output_config: {"effort": "low"} или "medium" |
Ниже effort — меньше выходных токенов |
| Без предварительного мышления | thinking: {"type": "between_tools"} |
Работает при low, medium, high; при xhigh или max — ошибка 400 |
| Самые сложные задачи | output_config: {"effort": "xhigh"} или "max" |
Используйте адаптивное мышление, а не between_tools |
thinking: {"type": "disabled"} на Sonnet 5.5 не принимается; between_tools — минимальная настройка (руководство по миграции).
Параметры, которые теперь возвращают ошибку 400
При переходе с Sonnet 4.6 или более ранних версий удалите эти параметры. Все пять перечислены в руководстве по миграции на Sonnet 5.5:
| Старый параметр | На Sonnet 5.5 | Чем заменить |
|---|---|---|
thinking: {"type": "enabled", "budget_tokens": N} |
Ошибка 400 | output_config.effort |
temperature, top_p, top_k |
Ошибка 400 | Инструкции в промпте; effort |
Префилл ассистента (последнее сообщение от assistant) |
Ошибка 400 | Структурированный вывод или системные инструкции |
Принудительный tool_choice (any или конкретный инструмент) |
Ошибка 400 | auto и чёткие инструкции по инструментам |
thinking: {"type": "disabled"} |
Ошибка 400 | thinking: {"type": "between_tools"} |
Также пересчитайте max_tokens и оценки стоимости с учётом примерно 30% роста числа токенов по сравнению с Sonnet 4.6. Если после обновления появились ошибки ID модели, наши руководства Claude: версия модели не найдена и ошибки 400 в Anthropic разбирают типичные причины.
Лимиты Claude Sonnet API
Anthropic публикует лимиты по уровням на странице лимитов. Для Sonnet 5.5 на 21 октября 2026 года:
| Уровень | Запросов в минуту | Входных токенов в минуту | Выходных токенов в минуту |
|---|---|---|---|
| Start | 1 000 | 2 000 000 | 400 000 |
| Build | 5 000 | 5 000 000 | 1 000 000 |
| Scale | 10 000 | 10 000 000 | 2 000 000 |
У Sonnet 5, Sonnet 4.x и Haiku 5.5 те же значения по уровням. Anthropic отмечает, что для большинства моделей входные токены, прочитанные из кэша, не учитываются в лимите входных токенов в минуту, поэтому кэширование промптов помогает и экономить, и обходить лимиты.
Сколько Sonnet 5.5 стоит на практике
Официальные цены на 21 октября 2026 года за 1M токенов (цены):
| Позиция | Цена |
|---|---|
| Вход | $2.00 |
| Выход | $10.00 |
| Запись в кэш, 5 минут | $2.50 |
| Запись в кэш, 1 час | $4.00 |
| Чтение кэша | $0.10 |
| Batch API вход / выход | $1.00 / $5.00 |
Инференс только в США (inference_geo) |
×1,1 ко всем ценам на токены |
Пример расчёта: ассистент поддержки обрабатывает 50 000 запросов в месяц; в каждом — закэшированный системный промпт на 3 000 токенов, 500 новых входных токенов и 400 выходных. Чтение кэша: 150M токенов × $0.10 = $15. Новый вход: 25M × $2 = $50. Выход: 20M × $10 = $200. Итого около $265 в месяц без учёта разовых записей в кэш. Основная часть — выход, поэтому effort важнее оптимизации входа. Сравнение по моделям — в ценах Claude API и маршрутизации API Claude и GPT.
Claude Sonnet через OpenAI SDK
У Anthropic есть OpenAI-совместимый эндпоинт https://api.anthropic.com/v1/, но на странице совместимости с OpenAI SDK он описан как инструмент для тестирования и сравнения, а не для большинства продакшен-сценариев: параметр strict в function calling игнорируется, response_format игнорируется, кэширование промптов не поддерживается. Для продакшена на Sonnet 5.5 используйте нативный Messages API, показанный выше. Подробнее о вариантах — в нашей статье о совместимости Claude API с OpenAI SDK.
Один ключ для Sonnet и других моделей: Flatkey
Если ваш продукт также обращается к GPT, Gemini или DeepSeek, Flatkey даёт один ключ и один предоплаченный баланс для всех моделей. На 21 октября 2026 года страница модели Claude Sonnet 5.5 у Flatkey указывала $1.60 за вход / $8.00 за выход на 1M токенов — на 20% ниже, чем $2 / $10 у Anthropic, а Sonnet 4.6 — $2.40 / $12.00. SDK Anthropic работает, если заменить base URL на https://router.flatkey.ai (без /v1), согласно руководству по Anthropic SDK от Flatkey:
import anthropic
client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
Настройка Claude Code описана в статье настройка API-роутера для Claude Code. Работайте с Anthropic напрямую, если вам нужны функции или договорённости, доступные только на её платформе, например определённые бета-заголовки в день релиза или корпоративный договор.
Частые вопросы
Как называется модель в Claude Sonnet API?
На 21 октября 2026 года актуальный ID — claude-sonnet-5-5 в Claude API, Google Cloud, Microsoft Foundry и Claude Platform on AWS и anthropic.claude-sonnet-5-5 в Amazon Bedrock. Более старые ID — claude-sonnet-5 и claude-sonnet-4-6.
Сколько стоит Claude Sonnet API?
Claude Sonnet 5.5 стоит $2 за миллион входных и $10 за миллион выходных токенов; чтение кэша — $0.10, Batch API — за полцены ($1 / $5), по данным страницы цен Anthropic на 21 октября 2026 года.
Claude Sonnet API бесплатный?
Нет. API Anthropic оплачивается за токены, бесплатного API-уровня для Sonnet нет. У потребительских приложений Claude есть свои бесплатные и платные тарифы, но они не связаны с оплатой API. Бесплатные варианты от других провайдеров — в нашем обзоре бесплатных LLM API.
Какое контекстное окно у Claude Sonnet 5.5?
1M токенов и до 128K выходных токенов на запрос, либо 300K в Message Batches API с бета-заголовком output-300k-2026-03-24.
Почему после обновления запрос к Sonnet возвращает ошибку 400?
Sonnet 5.5 отклоняет бюджеты мышления, temperature/top_p/top_k, префилл ассистента, принудительный выбор инструмента и thinking: {"type": "disabled"}. Удалите их и используйте output_config.effort или thinking: {"type": "between_tools"}.
Есть ли Claude Sonnet 5 API?
Да. claude-sonnet-5 по-прежнему доступна как устаревшая модель по $2 / $10 за миллион токенов, чтение кэша — $0.20. У Sonnet 5.5 та же цена за токен и вдвое более дешёвое чтение кэша, поэтому для новых проектов она — лучший выбор по умолчанию.
Источники
- Обзор Claude Sonnet 5.5 и руководство по миграции, проверено 21 октября 2026
- Цены Claude и обзор моделей, проверено 21 октября 2026
- Лимиты Claude API, effort, совместимость с OpenAI SDK, проверено 21 октября 2026
- Руководство Flatkey по Anthropic SDK и каталог моделей Flatkey, проверено 21 октября 2026
