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

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

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

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

wan-2-2-a14b-turbo

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

text, file

Files API

Требуется для reference-режимов

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

12

Возможность

Видео

Биллинг

FIXED

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

5000 символов

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

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

КлючТипОбязательноПо умолчаниюОписание
modelstringДаwan-2-2-a14b-turboИспользуйте wan-2-2-a14b-turbo как API model id.
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Только для маршрута от изображения с аудио. Включите ее, чтобы запустить проверки безопасности перед генерацией, или выключите, если нужна меньшая фильтрация и вы принимаете этот компромисс.

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

Сначала загрузите reference-файлы, затем поместите возвращенный URL и duration token в params.referenceMediaItems.

Правило reference-материалов

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

Макс. файлов

2

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

image, audio

Duration token

Видео- и аудио-reference должны передавать 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"
  }
}

Запрос с 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.