Claude Sonnet 5.5 API
Claude Sonnet 5.5 API: адаптивное мышление и режим between_tools, ограничения параметров, потоковые ответы и цены на токены и кеш по группам.
В этом справочнике описаны параметры Messages модели Claude Sonnet 5.5. Используйте claude-sonnet-5-5 с POST https://api.wanapi.app/v1/messages. Сравнить модели Claude.
Настройки модели
| Параметр | Claude Sonnet 5.5 |
|---|---|
| ID модели | claude-sonnet-5-5 |
| Контекстное окно | 1M токенов |
| Максимальный синхронный вывод | 128000 токенов, включая мышление |
| Режимы мышления | Адаптивное или between_tools |
| Усилие по умолчанию | high |
Принудительные вызовы инструментов (any / tool) | Не поддерживаются |
Подключение и отправка запроса
Создайте ключ в настройках API-ключей. Один API-ключ работает со всеми моделями и группами. Храните его в переменной окружения WAN_API_KEY на сервере. Передавайте anthropic-version: 2023-06-01; добавляйте anthropic-beta только для функций, которым он требуется.
curl https://api.wanapi.app/v1/messages \
-H "x-api-key: $WAN_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
}'import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["WAN_API_KEY"],
base_url="https://api.wanapi.app",
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))Текущие возможности API
Таблица ниже описывает нативную спецификацию модели. Сейчас Wan API передаёт запросы через слой совместимости. Используйте положительное значение max_tokens: шлюз заменяет 0 лимитом генерации, поэтому здесь это значение нельзя использовать только для предварительного заполнения кеша.
Текущий шлюз не передаёт diagnostics, compaction, fallbacks, fallback_credit_token и thread. При текущей конфигурации канала также отфильтровываются speed, service_tier и inference_geo. Эти поля описаны ниже для полноты спецификации модели, но через данное подключение они пока недоступны. Успешный ответ не означает, что проигнорированное поле подействовало. Это ограничение распространяется и на beta-функции, которым нужны такие поля.
Параметры
| Параметр | Тип / обязательность | Официальные ограничения и значения по умолчанию |
|---|---|---|
model | string, обязательный | claude-sonnet-5-5. |
max_tokens | integer, обязательный | 0–128000, включая токены мышления. По официальной спецификации 0 заполняет кеш промпта без генерации вывода; см. раздел «Текущие возможности API». |
messages | массив объектов, обязательный | Не менее одного сообщения в диалоге и не более 100000. Каждое содержит role и content; content — строка или массив блоков содержимого. Обычные реплики используют user/assistant. Сообщения system внутри диалога должны соответствовать официальным правилам размещения. |
system | string или массив текстовых блоков | Инструкции верхнего уровня. Текстовые блоки могут включать точки разделения кеша. |
thinking | object | По умолчанию: {"type":"adaptive"}. Другой поддерживаемый режим — {"type":"between_tools"}. Ручные бюджеты и disabled отклоняются. |
thinking.display | enum | Только в адаптивном режиме: omitted (по умолчанию) или summarized. Отсутствие сводки не означает, что мышление отключено. |
thinking.block_binding | object, beta | Только в адаптивном режиме. Требует thinking-binding-controls-2026-08-01; соблюдайте официальную спецификацию сохранения мышления. |
output_config.effort | enum или null | low, medium, high, xhigh, max; по умолчанию — high. Null сохраняет действие значения по умолчанию. |
output_config.format | object или null | Структурированный вывод JSON: {"type":"json_schema","schema":{...}}. Используйте поддерживаемое подмножество JSON Schema. |
stream | boolean | По умолчанию — false; true возвращает события SSE. |
stop_sequences | массив строк | По официальной спецификации останавливает генерацию при совпадении строки. В текущем тесте совместимости это поведение не соблюдалось. |
temperature | number или null | Для совместимости принимается только 1; опустите этот параметр. Другие значения, кроме null, отклоняются. |
top_p | number или null | Для совместимости принимается только 0.99–1; опустите этот параметр. |
top_k | значения, отличные от null, недопустимы | Настройки сэмплирования не поддерживаются; опустите это свойство. |
tools | массив объектов | Клиентские инструменты содержат name, input_schema и необязательные настройки описания и строгого режима. Серверные инструменты используют официальные определения с указанием версии. |
tool_choice | object | auto (по умолчанию) или none. any и принудительный выбор именованного tool отклоняются. auto может содержать disable_parallel_tool_use. |
metadata.user_id | string или null | Не более 512 символов; используйте непрозрачный идентификатор. |
cache_control | object или null | type: "ephemeral"; ttl: "5m" (по умолчанию) или "1h". Sonnet 5.5 требует не менее 512 токенов, пригодных для кеширования. Официальный API также поддерживает точки разделения кеша на уровне блоков. |
diagnostics | object или null | previous_message_id: строка длиной не более 256 символов или null. Запрашивает диагностику расхождений кеша. |
service_tier | enum | auto (по умолчанию) или standard_only. |
speed | enum или null | Опустите параметр либо используйте standard / null. Sonnet 5.5 не поддерживает fast. |
inference_geo | string или null | Официальное значение по умолчанию берётся из настроек аккаунта. Сам факт принятия запроса не подтверждает географическое место обработки. |
fallbacks | string, массив объектов или null, beta | "default" или до трёх записей fallback. Каждая требует model; необязательные переопределения — max_tokens, thinking, output_config и speed. См. правила fallback ниже. |
fallback_credit_token | string, object или null | Токен из предыдущего ответа с отказом либо {"token":"...","mode":"strict"}. Для объекта требуется fallback-credit-2026-07-01; mode — strict (по умолчанию) или best_effort. Нельзя совмещать с отличным от null значением fallbacks. |
container | string, object или null | ID контейнера либо его конфигурация с необязательными id и skills (не более 20). Skills используют официальные поля типа, идентификатора и версии. |
context_management | object или null | Официальная конфигурация редактирования контекста, включая edits; null означает отсутствие этой настройки. Ограничения совместимости правок для конкретной модели сохраняются. |
mcp_servers | массив объектов | Официальные определения серверов MCP с требованиями к версии beta и аутентификации сервера. Проверка с пустым массивом не подтверждает удалённое выполнение MCP. |
compaction | object или null, beta | {"type":"summarize"} с compact-2026-09-04; null означает отсутствие сжатия. Включённое сжатие нельзя совмещать с отличным от null значением context_management, стоп-последовательностями или форматом структурированного вывода. Поведение сжатия с подписью не прошло текущую проверку. |
messages[].output_config.effort | enum, beta | Уровень усилий для отдельного сообщения задаётся в сообщении system; требует mid-conversation-output-config-2026-07-01. Сообщения system, задающие только уровень усилий, могут находиться в любой позиции. Группы system с содержимым следуют официальным правилам размещения. В режиме between_tools этот параметр не должен менять уровень усилий. |
Мышление и инструменты
between_tools принимает только собственное свойство type и уровни усилий low, medium или high. Не отправляйте с ним display, budget_tokens или block_binding. Пример:
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"thinking": {"type": "between_tools"},
"output_config": {"effort": "medium"},
"messages": [{"role": "user", "content": "Explain this concept briefly."}]
}Предварительное заполнение ответа ассистента не поддерживается. Чтобы продолжить pause_turn, повторно отправьте возвращённое содержимое assistant для серверного инструмента без изменений. Сжатие обобщает существующую историю и не является предварительным заполнением ответа ассистента. Точно сохраняйте блоки мышления и подписи; не переносите их между моделями и не редактируйте более раннюю историю без соблюдения официальных правил привязки.
В нативном Claude API использование компьютера требует computer_toolset_20260801; computer_20251124 отклоняется. Конфигурации Advisor с claude-opus-4-8, claude-opus-4-7 или claude-sonnet-5 также отклоняются для этой исполняющей модели.
Входные медиа
Для изображений и PDF используйте общедоступные HTTP(S) URL в блоках content пользовательского сообщения. Размещайте файлы самостоятельно; данная интеграция не предоставляет Files API или загрузку файлов. Пример передачи изображения:
{"role":"user","content":[
{"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
{"type":"text","text":"What does this chart show?"}
]}Для PDF используйте блок document. При продолжении диалога сохраняйте ID вызовов инструментов, полные блоки мышления и подписи без изменений. Ваше приложение выполняет клиентские инструменты и возвращает их результаты; объявление инструмента не запускает его.
Цены
USD за 1 миллион токенов
Текущие тарифы включают множитель каждой группы. Цены кешируются на срок до 2 минут.
Один API-ключ работает со всеми моделями и группами. Метка «По умолчанию» обозначает первую подходящую группу в порядке автоматической маршрутизации; запрос оплачивается по тарифам фактически выбранной группы.
Claude Sonnet 5.5
claude-sonnet-5-5
| Оплачиваемые токены | claude · По умолчанию |
|---|---|
| Любая длина входа | |
| Вход (без кеша) | 1 $ |
| Выход | 5 $ |
| Чтение из кеша | 0,05 $ |
| Запись в кеш · 5 минут | 1,25 $ |
| Запись в кеш · 1 час | 2 $ |
— означает, что подтверждённая цена недоступна, а не что услуга бесплатна.
Тарифы кеша применяются только тогда, когда в ответе указано соответствующее использование кеша. Не учитывайте кешированные токены повторно как некешированный вход.
Умножьте количество оплачиваемых токенов каждого типа на соответствующий тариф и разделите общую сумму на 1,000,000. Токены мышления включаются в выходные токены и не оплачиваются повторно. Чтение из кеша, запись на 5 минут и запись на 1 час тарифицируются отдельно. Если цена зависит от длины входа, выберите подходящий диапазон перед расчётом стоимости запроса.
Ответ и потоковая передача
Завершённое сообщение содержит id, type, role, model, content, stop_reason и usage. Читайте текстовые блоки из content; первым блоком может оказаться мышление или вызов инструмента. Ниже приведён пример ответа:
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5-5",
"content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 24, "output_tokens": 18}
}Укажите stream: true для SSE и используйте curl -N. Обрабатывайте message_start, content_block_start, content_block_delta, content_block_stop, message_delta и message_stop, а также ping и ошибки потока. Читайте итоговые данные об использовании токенов, не воспринимайте каждый фрагмент как полный ответ.
Форматы, совместимые с OpenAI
Тот же ID модели работает с POST /v1/chat/completions и POST /v1/responses. Используйте Authorization: Bearer YOUR_API_KEY и базовый URL OpenAI SDK https://api.wanapi.app/v1. Chat Completions использует messages, а Responses — input. Их поля преобразуются в Messages, поэтому для описанных выше нативных параметров используйте /v1/messages.
curl https://api.wanapi.app/v1/chat/completions \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'Журнал вызовов и ошибки
Журнал LLM показывает завершённые вызовы за последние 7 дней: модель, входные и выходные токены, стоимость. Обновите страницу после вызова и примените фильтр claude-sonnet-5-5. Для изображений и видео используйте журнал задач.
Если запрос завершился ошибкой, проверьте HTTP-статус и объект error. Проверьте ключ, баланс, ID модели и допустимые сочетания параметров. Отказ модели или остановка по лимиту вывода отличаются от HTTP-ошибки. Если запрос или поток прервался, проверьте журнал перед повторной отправкой: новый запрос может привести к новому списанию.
Источники по модели
Claude Haiku 5.5
Claude Haiku 5.5 API: адаптивное или отключённое мышление, принудительные вызовы инструментов, параметры, потоковые ответы и цены по группам.
Claude Opus 5.5
Claude Opus 5.5 API: адаптивное мышление, усилие medium по умолчанию, параметры запросов, потоковые ответы и цены на токены по группам.