# Claude Fable 5.2 API (https://wanapi.app/ru/docs/claude-fable-5-2)





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

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

| Параметр                                            | Claude Fable 5.2                 |
| --------------------------------------------------- | -------------------------------- |
| ID модели                                           | `claude-fable-5-2`               |
| Контекстное окно                                    | 1M токенов                       |
| Максимальный синхронный вывод                       | 128000 токенов, включая мышление |
| Режимы мышления                                     | Адаптивное, всегда включено      |
| Усилие по умолчанию                                 | `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-fable-5-2",
    "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-fable-5-2",
    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-fable-5-2`. Используйте точный ID; группа выбирается автоматически.                                                   |
| `max_tokens`            | Обязательное целое число           | 0–128000, включая мышление. Ноль нельзя сочетать с stream true, структурированным выводом или принудительными инструментами.  |
| `messages`              | Обязательный массив                | 1–100000 сообщений по официальной спецификации; пустой массив допустим только при продолжении thread после pause\_turn.       |
| `system`                | Строка или массив текстовых блоков | При продолжении thread полностью пропустите поле.                                                                             |
| `thinking`              | Объект, по умолчанию adaptive      | Только adaptive. display: omitted (по умолчанию), summarized, updates или null.                                               |
| `output_config`         | Объект                             | effort: low, medium, high (по умолчанию), xhigh, max или null. Необязательные format и task\_budget.                          |
| `output_format`         | Объект или null                    | Устаревший псевдоним структурированного вывода; используйте output\_config.format.                                            |
| `stop_sequences`        | Массив строк                       | Не допускает null; несовместим со сжатием по запросу.                                                                         |
| `stream`                | Логическое значение, false         | При true возвращается SSE; null недопустим.                                                                                   |
| `tools`                 | Массив                             | Официальные клиентские и серверные инструменты или наборы инструментов. Клиентские инструменты выполняются вашим приложением. |
| `tool_choice`           | Объект                             | auto или none; принудительные вызовы инструментов отклоняются.                                                                |
| `metadata`              | Объект                             | user\_id — строка не длиннее 512 символов или null.                                                                           |
| `cache_control`         | Объект или null                    | type ephemeral, ttl 5m или 1h.                                                                                                |
| `container`             | Строка, объект или null            | Необязательный id и не более 20 skills.                                                                                       |
| `context_management`    | Объект или null                    | Официальные правки контекста; требуется соответствующая beta.                                                                 |
| `mcp_servers`           | Массив                             | Не более 20 HTTPS-серверов; требуется соответствующая beta MCP.                                                               |
| `diagnostics`           | Объект или null                    | previous\_message\_id — строка не длиннее 256 символов или null.                                                              |
| `service_tier`          | auto или standard\_only            | Необязательное поле; null недопустим.                                                                                         |
| `inference_geo`         | Строка или null                    | global или us, в зависимости от доступности для аккаунта.                                                                     |
| `speed`                 | Строка или null                    | standard, fast или null; для fast не нужна beta.                                                                              |
| `compaction`            | Объект или null                    | type summarize, необязательные instructions не длиннее 16384 символов Unicode.                                                |
| `fallbacks`             | default, массив или null           | Не более трёх разных целевых моделей; требуется официальная beta server-side-fallback.                                        |
| `fallback_credit_token` | Строка, объект или null            | Токен не длиннее 2048 символов; требуется официальная beta кредита; нельзя сочетать с fallbacks.                              |
| `thread`                | Объект или null                    | create либо continue с previous\_message\_id; требуется message-threads-2026-08-12.                                           |

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

Claude Fable 5.2 использует адаптивное мышление с усилием high по умолчанию. Режимы enabled, disabled и between\_tools, а также budget\_tokens не поддерживаются. Для `thinking.display: updates` требуется `thinking-display-updates-2026-08-18`. `thinking.block_binding` допускает prefix\_mismatch\_behavior со значением error, drop\_block или null при наличии `thinking-binding-controls-2026-08-01`.

Для `output_config.task_budget` требуются `task-budgets-2026-03-13`, type tokens, целочисленный total не меньше 20000 и необязательный неотрицательный целочисленный remaining. Пропустите remaining при использовании сжатия или повторной отправке подписанного блока сжатия. Сжатие по запросу требует `compact-2026-09-04` и несовместимо с context\_management, stop\_sequences, структурированным выводом или принудительными инструментами. Сжатие по порогу использует `compact-2026-01-12` с порогом input\_tokens не меньше 50000.

Для уровня усилий в отдельных системных сообщениях требуется mid-conversation-output-config-2026-07-01. Предварительное заполнение последнего ответа assistant отклоняется; официальные продолжения pause\_turn и сжатия остаются допустимыми.

Для работы с компьютером используйте computer\_toolset\_20260801. Инструменты Advisor требуют advisor-tool-2026-03-01 и поддерживаемую целевую модель. Ваше приложение управляет выполнением инструментов и разрешениями.

При продолжении thread отправляйте только новые сообщения и не передавайте system и tools. Продолжение нельзя сочетать со сжатием или правками контекста, кроме сохранения всего мышления. Состояние истекает через пять минут без запросов; храните диалог локально. Ограничения, зависящие от состояния, проверяются при продолжении.

Целевые модели fallback для Fable 5.2 — Claude Opus 4.8 и Claude Opus 5. Работа расширенных 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 Fable 5.2

`claude-fable-5-2`

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

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

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

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

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

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

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

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

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

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

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

* [Обзор модели](https://platform.claude.com/docs/en/models/fable-5-2/overview)
* [Справочник Messages](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Мышление](https://platform.claude.com/docs/en/build-with-claude/thinking)
