Документация Rivya AI
Страницы API моделей

Интеграция Wan 2.2 A14B Turbo API

Используйте Wan 2.2 A14B Turbo через Rivya Public API v1: ID модели wan-2-2-a14b-turbo, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIТекст или URL готовы; референсные режимы используют Files APIВидео
ID модели API

wan-2-2-a14b-turbo

Входные данные

text, file

Files API

Требуется для референсных режимов

Базовые кредиты

12

Возможность

Видео

Биллинг

FIXED

Лимит промпта

5000 символов

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

КлючТипОбязательноПо умолчаниюОписание
modelstringДаwan-2-2-a14b-turboИспользуйте wan-2-2-a14b-turbo как ID модели API.
promptstringДа-Максимум 5000 символов для этой модели.
paramsobjectНет-Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_idstringНет-Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
resolutionselectНет720p-480p, 580p, 720pТекстовые запуски и запуски от изображения сейчас остаются на `480p / 720p`, а маршрут от изображения с аудио также открывает `580p`. Rivya автоматически фильтрует неподдерживаемые уровни на основе текущего режима.
aspect_ratioselectНет16:9-16:9, 9:16Это остается доступным только в текст-в-видео, потому что текущие публичные эндпоинты изображения и изображения с аудио не открывают стабильное поле `aspect_ratio`.
enable_prompt_expansionselectНетfalse-false, trueВключите это, когда хотите, чтобы вышестоящий сервис расширил грубый текстовый промпт перед генерацией. Опция остается ограниченной текстовыми запусками и запусками от изображения.
seednumberНет-min 0 / max 2147483647-Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1.
accelerationselectНетnone-none, regularБолее легкий контроль ускорения, который остается ограниченным публичными текстовым режимом и режимом изображения.
num_framesnumberНет80min 40 / max 120 / step 1-Только для маршрута от изображения с аудио. Допустимые значения от 40 до 120, и число должно делиться на 4. Типичная начальная точка - 80.
frames_per_secondnumberНет16min 4 / max 60 / step 1-Только для маршрута от изображения с аудио. Допустимые значения от 4 до 60. Более высокий FPS обычно ощущается плавнее, но также повышает нагрузку генерации.
negative_prompttextНет---Только для маршрута от изображения с аудио. Используйте его, чтобы описать сбои движения, нежелательные артефакты или визуальные элементы, которых нужно избежать.
num_inference_stepsnumberНет27min 2 / max 40 / step 1-Только для маршрута от изображения с аудио. Допустимые значения от 2 до 40. Большее число шагов может улучшить качество, но также увеличивает время выполнения.
guidance_scalenumberНет3.5min 1 / max 10 / step 0.1-Только для маршрута от изображения с аудио. Допустимые значения от 1 до 10. Более высокие значения следуют промпту точнее, но также могут сделать движение более скованным.
shiftnumberНет5min 1 / max 10 / step 0.1-Только для маршрута от изображения с аудио. Допустимые значения от 1 до 10. Он меняет ощущение временного смещения генерации, поэтому безопаснее начинать рядом со значением по умолчанию.
enable_safety_checkerselectНетtrue-true, falseТолько для маршрута от изображения с аудио. Включите ее, чтобы запустить проверки безопасности перед генерацией, или выключите, если нужна меньшая фильтрация и вы принимаете этот компромисс.

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Референсные медиа: Загрузите до 2 ассетов. Текстовому режиму ничего не нужно, изображение-в-видео использует 1 изображение, а маршрут от изображения с аудио использует 1 изображение плюс 1 аудиоклип.

Макс. файлов

2

Принимаемые типы файлов

image, audio

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kindМакс. размерMIME-типы
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/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"
  }
}

Запрос с референсным файлом

{
  "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

Некоторым режимам нужны референсные файлы, загруженные через Files API.