# Claude Sonnet 5.5 API (https://wanapi.app/ru/docs/claude-sonnet-5-5)





В этом справочнике описаны параметры Messages модели **Claude Sonnet 5.5**. Используйте `claude-sonnet-5-5` с `POST https://api.wanapi.app/v1/messages`. [Сравнить модели Claude](/ru/docs/claude-api).

## Настройки модели [#настройки-модели]

| Параметр                                            | Claude Sonnet 5.5                |
| --------------------------------------------------- | -------------------------------- |
| ID модели                                           | `claude-sonnet-5-5`              |
| Контекстное окно                                    | 1M токенов                       |
| Максимальный синхронный вывод                       | 128000 токенов, включая мышление |
| Режимы мышления                                     | Адаптивное или between\_tools    |
| Усилие по умолчанию                                 | `high`                           |
| Принудительные вызовы инструментов (`any` / `tool`) | Не поддерживаются                |

## Подключение и отправка запроса [#подключение-и-отправка-запроса]

Создайте ключ в [настройках API-ключей](/ru/settings/apikeys). Один API-ключ работает со всеми моделями и группами. Храните его в переменной окружения `WAN_API_KEY` на сервере. Передавайте `anthropic-version: 2023-06-01`; добавляйте `anthropic-beta` только для функций, которым он требуется.

```bash
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."}]
  }'
```

```python
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 [#текущие-возможности-api]

Таблица ниже описывает нативную спецификацию модели. Сейчас Wan API передаёт запросы через слой совместимости. &#x2A;*Используйте положительное значение `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`. Пример:

```json
{
  "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 или загрузку файлов. Пример передачи изображения:

```json
{"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`; первым блоком может оказаться мышление или вызов инструмента. Ниже приведён пример ответа:

```json
{
  "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 [#форматы-совместимые-с-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`.

```bash
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](/ru/usage) показывает завершённые вызовы за последние 7 дней: модель, входные и выходные токены, стоимость. Обновите страницу после вызова и примените фильтр `claude-sonnet-5-5`. Для изображений и видео используйте [журнал задач](/ru/tasks).

Если запрос завершился ошибкой, проверьте HTTP-статус и объект `error`. Проверьте ключ, [баланс](/ru/docs/balance), ID модели и допустимые сочетания параметров. Отказ модели или остановка по лимиту вывода отличаются от HTTP-ошибки. Если запрос или поток прервался, проверьте журнал перед повторной отправкой: новый запрос может привести к новому списанию.

## Источники по модели [#источники-по-модели]

* [Официальный обзор Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
* [Изменения и ограничения Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
* [Справочник параметров Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Уровень усилий для отдельных сообщений](https://platform.claude.com/docs/en/build-with-claude/effort)
* [Сжатие по запросу](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand)
* [Отказы и резервные модели](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)
* [Кредит для повторного запроса](https://platform.claude.com/docs/en/build-with-claude/fallback-credit)
