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





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

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

| Параметр                                            | Claude Opus 5.5                  |
| --------------------------------------------------- | -------------------------------- |
| ID модели                                           | `claude-opus-5-5`                |
| Контекстное окно                                    | 1M токенов                       |
| Максимальный синхронный вывод                       | 128000 токенов, включая мышление |
| Режимы мышления                                     | Адаптивное, всегда включено      |
| Усилие по умолчанию                                 | `medium`                         |
| Принудительные вызовы инструментов (`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-opus-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-opus-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-opus-5-5`.                                                                                                                                                                                                                                                  |
| `max_tokens`                                                                                              | integer              | Да           | —                      | 0–128000. Включает токены, потраченные на мышление. `0` только предварительно прогревает кеш промпта.                                                                                                                                                               |
| `messages`                                                                                                | object\[]            | Да           | —                      | Чередующиеся сообщения `user` и `assistant`; `content` — строка или массив блоков контента. Последнее сообщение должно иметь роль `user`. Исключение: чтобы продолжить ответ `pause_turn`, отправьте его содержимое без изменений последним сообщением `assistant`. |
| `system`                                                                                                  | string или object\[] | Нет          | —                      | Системный промпт.                                                                                                                                                                                                                                                   |
| `thinking`                                                                                                | object               | Нет          | `{"type": "adaptive"}` | Мышление адаптивное и всегда включено. `display`: `omitted` (по умолчанию) или `summarized`.                                                                                                                                                                        |
| `output_config.effort`                                                                                    | enum                 | Нет          | `medium`               | `low`, `medium`, `high`, `xhigh`, `max`. Управляет глубиной рассуждений модели.                                                                                                                                                                                     |
| `output_config.format`                                                                                    | object               | Нет          | —                      | JSON-схема для структурированного вывода.                                                                                                                                                                                                                           |
| `stop_sequences`                                                                                          | string\[]            | Нет          | —                      | Остановить при генерировании одной из этих строк.                                                                                                                                                                                                                   |
| `stream`                                                                                                  | boolean              | Нет          | `false`                | Транслировать ответ как серверные события.                                                                                                                                                                                                                          |
| `temperature`                                                                                             | number               | Нет          | —                      | Для обратной совместимости принимается только `1` (значение по умолчанию); любое другое значение возвращает ошибку 400. Опустите этот параметр.                                                                                                                     |
| `top_p`                                                                                                   | number               | Нет          | —                      | Для обратной совместимости принимаются только значения от `0.99` до `1`; любое другое значение возвращает ошибку 400. Опустите этот параметр.                                                                                                                       |
| `top_k`                                                                                                   | integer              | Нет          | —                      | Не принимается: любое значение возвращает ошибку 400. Опустите этот параметр.                                                                                                                                                                                       |
| `tools`                                                                                                   | object\[]            | Нет          | —                      | Определения инструментов.                                                                                                                                                                                                                                           |
| `tool_choice`                                                                                             | object               | Нет          | —                      | `auto` или `none`; принудительный выбор инструмента (`any` или `tool`) не поддерживается этой моделью.                                                                                                                                                              |
| `metadata.user_id`                                                                                        | string               | Нет          | —                      | Непрозрачный идентификатор вашего пользователя, до 512 символов.                                                                                                                                                                                                    |
| `cache_control`                                                                                           | object               | Нет          | —                      | Точка кеширования промпта верхнего уровня.                                                                                                                                                                                                                          |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —                    | Нет          | —                      | Нативные необязательные поля; список полей, отфильтровываемых этим подключением, см. в разделе «Текущие возможности API».                                                                                                                                           |

## Мышление и инструменты [#мышление-и-инструменты]

Claude Opus 5.5 всегда использует адаптивное мышление: модель решает, сколько думать, а `output_config.effort` управляет этим. Более высокие усилия обычно означают больше выходных токенов, более длительное ожидание и более высокую стоимость. При установке `thinking.display` на `summarized` ответ включает блоки `thinking`, которые вы можете показать; при `omitted` они опускаются. Токены мышления тарифицируются как выходные токены.

## Входные медиа [#входные-медиа]

Для изображений и 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 Opus 5.5

`claude-opus-5-5`

| Оплачиваемые токены | claude · По умолчанию · Любая длина входа |
| --- | ---: |
| Вход (без кеша) | 2 $ |
| Выход | 10 $ |
| Чтение из кеша | 0,1 $ |
| Запись в кеш · 5 минут | 2,5 $ |
| Запись в кеш · 1 час | 4 $ |

— означает, что подтверждённая цена недоступна, а не что услуга бесплатна.

Тарифы кеша применяются только тогда, когда в ответе указано соответствующее использование кеша. Не учитывайте кешированные токены повторно как некешированный вход.

Умножьте количество оплачиваемых токенов каждого типа на соответствующий тариф и разделите общую сумму на 1,000,000. Токены мышления включаются в выходные токены и не оплачиваются повторно. Чтение из кеша, запись на 5 минут и запись на 1 час тарифицируются отдельно. Если цена зависит от длины входа, выберите подходящий диапазон перед расчётом стоимости запроса.

## Ответ и потоковая передача [#ответ-и-потоковая-передача]

Завершённое сообщение содержит `id`, `type`, `role`, `model`, `content`, `stop_reason` и `usage`. Читайте текстовые блоки из `content`; первым блоком может оказаться мышление или вызов инструмента. Ниже приведён пример ответа:

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-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-opus-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

## Журнал вызовов и ошибки [#журнал-вызовов-и-ошибки]

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

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