Claude Sonnet 5.5

Используйте claude-sonnet-5-5 в формате Anthropic Messages. В этом документе официальная спецификация запросов отделена от поведения, наблюдавшегося в тестах совместимости. Некоторые расширенные настройки пока работают не так, как указано в спецификации. Прежде чем полагаться на них, изучите ограничения.

Актуальные цены на входные и выходные токены, а также кэш приведены на странице модели.

Быстрый старт

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_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 how a rainbow forms in three sentences."}]
  }'

POST /v1/messages принимает аутентификацию через x-api-key или Bearer и anthropic-version: 2023-06-01. Отправляйте заголовок anthropic-beta для функций, официальная документация которых этого требует. Храните учётные данные в серверном коде.

Модель также принимает базовые запросы OpenAI Chat Completions (POST /v1/chat/completions) и Responses (POST /v1/responses). Для описанных ниже нативных параметров используйте Messages: преобразование формата OpenAI не обеспечивает все возможности Anthropic.

Официальная спецификация параметров

У Sonnet 5.5 контекстное окно составляет 1M токенов, а предел синхронного вывода — 128000 токенов. Ограничения вывода, относящиеся к Batch, к этому эндпоинту не применяются. Если в таблице не указано иное, приложение не задаёт значения по умолчанию для необязательных свойств.

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 также отклоняются для этой исполняющей модели.

Поля запроса fallback

Официальная бета-функция fallbacks повторяет запросы при отказах классификатора, соответствующих условиям повторной попытки. Она не повторяет запросы при ограничениях частоты, перегрузке или серверных ошибках, и отказ может сохраниться. Отправляйте server-side-fallback-2026-07-01 для "default" или явного списка; server-side-fallback-2026-06-01 поддерживает только список. Другие версии с датой отклоняются.

Явный список содержит не более трёх записей с разными моделями; ни одна не должна совпадать с запрошенной моделью. Разрешённые целевые модели берутся из allowed_fallback_models в beta Models API. В каждой записи допускаются только model, max_tokens, thinking, output_config и speed; переопределённые значения должны быть допустимы для целевой модели. При соответствующем переключении июльская beta преобразует between_tools у Sonnet 5.5 в disabled у Sonnet 5, опуская display. При использовании июньской beta задайте переопределение мышления Sonnet 5 самостоятельно.

fallback_credit_token предназначен для отдельной повторной попытки после отказа. Строка выбирает строгое применение кредита; объект добавляет mode. В режиме strict неудача при применении кредита приводит к отклонению повторной попытки. В режиме best_effort сбой на уровне токена может позволить продолжить запрос по обычной цене и отражается в usage.fallback_credit. Некорректно сформированные токены и совмещение кредита с fallbacks по-прежнему приводят к ошибке. Применение кредита также требует соблюдения условий для запроса, аккаунта, рабочего пространства, платформы и пятиминутного окна, описанных в официальном руководстве по кредиту.

Запрос с безобидным содержимым, fallbacks: "default", июльским beta-заголовком и speed: "standard" вернул ожидаемый текст. Это подтверждает только принятие запроса: выполнение fallback и применение кредита здесь не прошли сквозную проверку.

Входные данные для медиа и инструментов

Изображения используют блоки image, а PDF — блоки document в сообщении пользователя. Официальные типы источников включают публичные URL и base64 с соответствующим MIME-типом. В проверках совместимости использовались PNG в base64 и одностраничный PDF в base64; содержимое ответов также было проверено. Проверки не охватывали все URL и все границы размера файлов, разрешения изображений или количества страниц PDF.

Клиентские инструменты используют стандартный обмен tool_use → tool_result. Сохраняйте ID вызовов инструментов без изменений и возвращайте результат в сообщении пользователя. Успешный пример инструмента в строгом режиме подтверждает аргументы этого примера, а не все поддерживаемые ключевые слова JSON Schema.

Ответы

Непотоковый ответ содержит id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence и usage, а также необязательные официальные поля, такие как container, diagnostics, context_management, stop_details и beta-поля ответа. Содержимое может включать текст, мышление, вызовы инструментов, результаты инструментов или другие официальные типы блоков; не предполагайте, что первый блок обязательно содержит текст.

При потоковой передаче обрабатывайте message_start, content_block_start, content_block_delta, content_block_stop, message_delta и message_stop. Ошибки могут возникать и внутри потока. Данные использования могут содержать обычные входные/выходные токены, сведения о токенах мышления, чтение кэша и раздельные счётчики создания кэша со сроком 5 минут / 1 час.

Официальный отказ классификатора — это обычный ответ с stop_reason: "refusal" и stop_details, а не ошибка HTTP. В ответе fallback поле model указывает модель, которая ответила, блоки содержимого fallback обозначают переходы, а usage.iterations описывает попытки. Проверяйте эти поля вместо предположения, что ответила запрошенная модель. Такое поведение ответов здесь остаётся непроверенным.

Ошибки Messages имеют формат {"type":"error","error":{"type":"...","message":"..."}}. Неуспешные запросы не оплачиваются.

Проверка совместимости: 2026-10-01

Выполнение beta-инструментов, реальные соединения MCP, ссылки Files API, географическая резидентность данных, повторная отправка подписей мышления, полные пределы контекста/вывода, граничные случаи медиа и поведение отказов/fallback не прошли сквозную проверку. HTTP 200 и возвращённое имя модели не подтверждают, какая модель действительно выполнялась, и не доказывают, что все переданные настройки вступили в силу.

Источники

• Официальный обзор Sonnet 5.5
• Изменения и ограничения Sonnet 5.5
• Справочник параметров Messages
• Уровень усилий для отдельных сообщений
• Сжатие по запросу
• Отказы и fallback
• Кредит fallback
• Схема OpenAPI
• Markdown для копирования