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

Интеграция Wan 2.7 Video API

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

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

wan-2-7-video

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

text, file

Files API

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

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

80

Возможность

Видео

Биллинг

FIXED

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

5000 символов

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

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

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

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

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
resolutionselectНет720p-720p, 1080pРазрешение
durationselectНет5-5, 10, 15Текстовые запуски и запуски от изображения могут использовать 5, 10 или 15 секунд. Видеоредактирование сейчас ограничено 10 секундами, и Rivya автоматически нормализует более длинный выбор в этом режиме.
aspect_ratioselectНет16:9-16:9, 9:16, 1:1, 4:3, 3:4Запуски текст-в-видео и видеоредактирования используют это напрямую. Изображение-в-видео сейчас следует геометрии загруженного кадра вместо отдельного переключателя соотношения сторон.
negative_prompttextНет---Негативный промпт
prompt_extendselectНетtrue-true, falseУправляет тем, переписывает ли модель ваш промпт перед генерацией. Оставьте включенным для удобства или выключите, когда у вас уже есть очень точный промпт.
watermarkselectНетfalse-false, trueВодяной знак
audio_settingselectНетauto-auto, originУправляет обработкой аудио в маршруте видеоредактирования. Авто позволяет модели решать, а Сохранить исходное пытается сохранить аудио исходного видео.
seednumberНет-min 0 / max 2147483647-Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1.

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

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

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

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

Макс. файлов

2

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

image, video

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

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

kindМакс. размерMIME-типы
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/mp4, video/quicktime

Минимальный запрос

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Необязательные исключения или режимы сбоя, которых нужно избежать.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

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

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Необязательные исключения или режимы сбоя, которых нужно избежать.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "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.