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





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

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

| Параметр                                            | Claude Haiku 5.5                 |
| --------------------------------------------------- | -------------------------------- |
| ID модели                                           | `claude-haiku-5-5`               |
| Максимальный синхронный вывод                       | 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-haiku-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-haiku-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`                 | Да          | `claude-haiku-5-5`.                                                                                                                             |
| `max_tokens`            | Да          | Целое число 0–128000, включая мышление. В API нет значения по умолчанию.                                                                        |
| `messages`              | Да          | 1–100000 сообщений с ролью и строкой или массивом блоков содержимого. Правила диалога приведены ниже.                                           |
| `system`                | Нет         | Строка или массив текстовых блоков. Не null.                                                                                                    |
| `thinking`              | Нет         | По умолчанию adaptive; можно выбрать disabled. Нет ручного бюджета и режима between\_tools.                                                     |
| `output_config`         | Нет         | Объект с `effort`, `format` и необязательным beta-полем `task_budget`.                                                                          |
| `stop_sequences`        | Нет         | Массив строк остановки.                                                                                                                         |
| `stream`                | Нет         | Логическое значение; по умолчанию false.                                                                                                        |
| `temperature`           | Нет         | Не указывайте. Здесь отбрасывается; официальное значение для совместимости — 1.                                                                 |
| `top_p`                 | Нет         | Не указывайте. Здесь отбрасывается; официальное значение для совместимости — 0.99.                                                              |
| `top_k`                 | Нет         | Не поддерживается и отбрасывается.                                                                                                              |
| `tools`                 | Нет         | Массив клиентских инструментов или официальных объявлений серверных инструментов.                                                               |
| `tool_choice`           | Нет         | `auto`, `none`, `any` или именованный `tool`. Принудительные инструменты поддерживаются.                                                        |
| `metadata`              | Нет         | Объект; необязательный `user_id` — строка не длиннее 512 символов или null.                                                                     |
| `cache_control`         | Нет         | Null или `{"type":"ephemeral","ttl":"5m"}`; TTL также принимает `1h`. По умолчанию TTL — 5m.                                                    |
| `container`             | Нет         | Null, строка ID контейнера или объект с необязательным ID и не более чем 20 навыками.                                                           |
| `context_management`    | Нет         | Null или объект с официальными правками контекста; действуют требования beta-заголовков.                                                        |
| `mcp_servers`           | Нет         | Массив не более чем 20 серверов URL; требуется соответствующий beta-заголовок MCP.                                                              |
| `service_tier`          | Нет         | `auto` или `standard_only`. У Haiku нет мощностей Priority Tier.                                                                                |
| `inference_geo`         | Нет         | `global`, `us` или null. Без поля используется настройка аккаунта; прежде чем предполагать регион, проверьте отчётный расход.                   |
| `diagnostics`           | Нет         | Null или объект; `previous_message_id` — null или строка не длиннее 256 символов.                                                               |
| `compaction`            | Нет         | Null или `{"type":"summarize","instructions":"..."}`. Инструкции необязательны, допускают null и не превышают 16384 символа.                    |
| `fallbacks`             | Нет         | Null или `default` с соответствующей beta. У Haiku нет моделей автоматической замены; явные списки недопустимы.                                 |
| `fallback_credit_token` | Нет         | Null, строка токена или `{token,mode}`. API должен проверить право использования и действительность; не считайте любую модель допустимой целью. |
| `speed`                 | Нет         | `standard` или null. Быстрый режим не поддерживается.                                                                                           |

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

По умолчанию используется адаптивное мышление с усилием **medium** и без текста мышления. Уровень усилий принимает `low`, `medium`, `high`, `xhigh`, `max` или null для значения по умолчанию.

```json
{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}
```

Чтобы отключить мышление, используйте `{"type":"disabled"}` с low, medium или high. В режиме disabled не включайте `display` или `block_binding`. `enabled`, `budget_tokens`, `between_tools` и отключённое мышление при xhigh/max недопустимы.

При adaptive параметр `display` принимает `omitted`, `summarized` или null. Общее beta-значение `updates` требует `thinking-display-updates-2026-08-18`; Anthropic пока не подтверждает читаемые обновления хода работы для Haiku, поэтому не полагайтесь на такой вывод.

Необязательный `thinking.block_binding` требует `thinking-binding-controls-2026-08-01`. Это null или объект с `prefix_mismatch_behavior`, равным `error`, `drop_block` или null. При повторной отправке истории сохраняйте предыдущие ходы диалога и полные блоки мышления без изменений. Подписи мышления привязаны к создавшему их аккаунту или связанному с ним аккаунту.

`output_config.task_budget` — null или `{ "type": "tokens", "total": 20000 }` с необязательным целым числом/null `remaining`. Требуется `task-budgets-2026-03-13`; `total` должен быть не меньше 20000. Дополнительный диапазон `remaining` здесь не задаётся.

### Инструменты и структурированный вывод [#инструменты-и-структурированный-вывод]

Клиентские инструменты требуют имени из 1–128 букв, цифр, подчёркиваний или дефисов и `input_schema` с `type: "object"`. Используйте `tool_choice: {"type":"any"}` или `{"type":"tool","name":"lookup"}`, чтобы принудительно вызвать объявленный инструмент. При адаптивном мышлении ответ с принудительным инструментом начинается с вызова инструмента без блока мышления.

`disable_parallel_tool_use` — необязательное логическое значение для вариантов auto, any и tool; оно не является полем none. Возвращайте результат инструмента с исходным `tool_use_id`. Ваше приложение выполняет клиентские инструменты.

```json
{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}
```

Структурированные ответы используют `output_config.format: {"type":"json_schema","schema":{...}}`. Соблюдайте поддерживаемое Anthropic подмножество JSON Schema, включая `additionalProperties: false` для объектов. Корректная структура не гарантирует фактическую правильность значений. Строгие инструменты и структурированный вывод имеют ограничения на всю схему; см. [официальный справочник структурированного вывода](https://platform.claude.com/docs/en/build-with-claude/structured-outputs).

Работа с компьютером требует `computer_toolset_20260801`; старые версии инструментов компьютера недопустимы. Для браузера есть собственный `browser_toolset_20260801`. Объявление инструмента не подтверждает работоспособность полной сессии серверного инструмента. Перед использованием изучите его официальное руководство и требования beta.

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

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

`claude-haiku-5-5`

| Оплачиваемые токены | claude · По умолчанию · ≤ 100 000 входных токенов | claude · По умолчанию · > 100 000 входных токенов |
| --- | ---: | ---: |
| Вход (без кеша) | 0,05 $ | 0,25 $ |
| Выход | 0,25 $ | 1,25 $ |
| Чтение из кеша | 0,005 $ | 0,025 $ |
| Запись в кеш · 5 минут | 0,0625 $ | 0,3125 $ |
| Запись в кеш · 1 час | 0,1 $ | 0,5 $ |

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

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

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

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

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

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

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

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

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

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

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

* [Обзор модели Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview)
* [Руководство по переходу на Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
* [Справочник Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Справочник Beta Messages](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Мышление](https://platform.claude.com/docs/en/build-with-claude/thinking), [Уровень усилий](https://platform.claude.com/docs/en/build-with-claude/effort), [Бюджеты задач](https://platform.claude.com/docs/en/build-with-claude/task-budgets)
* [Сжатие по запросу](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand), [Редактирование контекста](https://platform.claude.com/docs/en/build-with-claude/context-editing)
* [Кеширование промптов](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), [Обработка изображений](https://platform.claude.com/docs/en/build-with-claude/vision), [Поддержка PDF](https://platform.claude.com/docs/en/build-with-claude/pdf-support)
