Интеграция Wan 2.2 A14B Turbo API
Используйте Wan 2.2 A14B Turbo через Rivya Public API v1: model id wan-2-2-a14b-turbo, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
wan-2-2-a14b-turbo
text, file
Требуется для reference-режимов
12
Видео
FIXED
5000 символов
Контракт запроса
Передавайте model id на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | wan-2-2-a14b-turbo | Используйте wan-2-2-a14b-turbo как API model id. |
| prompt | string | Да | - | Максимум 5000 символов для этой модели. |
| params | object | Нет | - | Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
| Ключ | Тип | Обязательно | По умолчанию | Диапазон | Варианты | Описание |
|---|---|---|---|---|---|---|
| resolution | select | Нет | 720p | - | 480p, 580p, 720p | Текстовые запуски и запуски от изображения сейчас остаются на `480p / 720p`, а маршрут от изображения с аудио также открывает `580p`. Rivya автоматически фильтрует неподдерживаемые уровни на основе текущего режима. |
| aspect_ratio | select | Нет | 16:9 | - | 16:9, 9:16 | Это остается доступным только в текст-в-видео, потому что текущие публичные эндпоинты изображения и изображения с аудио не открывают стабильное поле `aspect_ratio`. |
| enable_prompt_expansion | select | Нет | false | - | false, true | Включите это, когда хотите, чтобы вышестоящий сервис расширил грубый текстовый промпт перед генерацией. Опция остается ограниченной текстовыми запусками и запусками от изображения. |
| seed | number | Нет | - | min 0 / max 2147483647 | - | Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1. |
| acceleration | select | Нет | none | - | none, regular | Более легкий контроль ускорения, который остается ограниченным публичными текстовым режимом и режимом изображения. |
| num_frames | number | Нет | 80 | min 40 / max 120 / step 1 | - | Только для маршрута от изображения с аудио. Допустимые значения от 40 до 120, и число должно делиться на 4. Типичная начальная точка - 80. |
| frames_per_second | number | Нет | 16 | min 4 / max 60 / step 1 | - | Только для маршрута от изображения с аудио. Допустимые значения от 4 до 60. Более высокий FPS обычно ощущается плавнее, но также повышает нагрузку генерации. |
| negative_prompt | text | Нет | - | - | - | Только для маршрута от изображения с аудио. Используйте его, чтобы описать сбои движения, нежелательные артефакты или визуальные элементы, которых нужно избежать. |
| num_inference_steps | number | Нет | 27 | min 2 / max 40 / step 1 | - | Только для маршрута от изображения с аудио. Допустимые значения от 2 до 40. Большее число шагов может улучшить качество, но также увеличивает время выполнения. |
| guidance_scale | number | Нет | 3.5 | min 1 / max 10 / step 0.1 | - | Только для маршрута от изображения с аудио. Допустимые значения от 1 до 10. Более высокие значения следуют промпту точнее, но также могут сделать движение более скованным. |
| shift | number | Нет | 5 | min 1 / max 10 / step 0.1 | - | Только для маршрута от изображения с аудио. Допустимые значения от 1 до 10. Он меняет ощущение временного смещения генерации, поэтому безопаснее начинать рядом со значением по умолчанию. |
| enable_safety_checker | select | Нет | true | - | true, false | Только для маршрута от изображения с аудио. Включите ее, чтобы запустить проверки безопасности перед генерацией, или выключите, если нужна меньшая фильтрация и вы принимаете этот компромисс. |
Политика загрузки
Сначала загрузите reference-файлы, затем поместите возвращенный URL и duration token в params.referenceMediaItems.
Референсные медиа: Загрузите до 2 ассетов. Текстовому режиму ничего не нужно, изображение-в-видео использует 1 изображение, а маршрут от изображения с аудио использует 1 изображение плюс 1 аудиоклип.
2
image, audio
Видео- и аудио-reference должны передавать durationToken из /api/v1/files, когда требуется проверка длительности.
| kind | Макс. размер | MIME-типы |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
| audio | 10 MB | audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma |
Минимальный запрос
{
"model": "wan-2-2-a14b-turbo",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"acceleration": "none",
"num_frames": 80,
"frames_per_second": 16,
"negative_prompt": "Необязательные исключения или режимы сбоя, которых нужно избежать.",
"num_inference_steps": 27,
"guidance_scale": 3.5,
"shift": 5,
"enable_safety_checker": "true"
}
}Запрос с reference-файлом
{
"model": "wan-2-2-a14b-turbo",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"acceleration": "none",
"num_frames": 80,
"frames_per_second": 16,
"negative_prompt": "Необязательные исключения или режимы сбоя, которых нужно избежать.",
"num_inference_steps": 27,
"guidance_scale": 3.5,
"shift": 5,
"enable_safety_checker": "true",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Ответ создания
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.
{
"id": "task_wan_2_2_a14b_turbo_example",
"status": "queued",
"model": "wan-2-2-a14b-turbo",
"reserved_credits": 12,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Распространенные ошибки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Некоторым режимам нужны reference-файлы, загруженные через Files API.