Використовуйте 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

Потрібно для референсних режимів

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

Можливість

Відео

Білінг

FIXED

Ліміт промпта

5000 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

Ключ	Тип	Обов'язково	За замовчуванням	Опис
model	string	Так	wan-2-7-video	Використовуйте wan-2-7-video як ID моделі API.
prompt	string	Так	-	Максимум 5000 символів для цієї моделі.
params	object	Ні	-	Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_id	string	Ні	-	Необов'язковий клієнтський ID для трасування запитів у вашій системі.

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

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
resolution	select	Ні	720p	-	720p, 1080p	Роздільність
duration	select	Ні	5	-	5, 10, 15	Запуски з тексту й зображення можуть використовувати 5, 10 або 15 секунд. Редагування відео зараз обмежене 10 секундами, і Rivya автоматично нормалізує довші вибори в цьому режимі.
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Запуски з тексту у відео та редагування відео використовують це напряму. Відео із зображення зараз наслідує геометрію завантаженого кадру замість окремого перемикача співвідношення сторін.
negative_prompt	text	Ні	-	-	-	Негативний промпт
prompt_extend	select	Ні	true	-	true, false	Керує тим, чи модель переписує ваш промпт перед генерацією. Залиште увімкненим для зручності або вимкніть, якщо у вас уже є дуже точний промпт.
watermark	select	Ні	false	-	false, true	Водяний знак
audio_setting	select	Ні	auto	-	auto, origin	Керує обробкою аудіо в шляху редагування відео. Автоматичний режим дозволяє моделі вирішити самостійно, а режим збереження оригіналу намагається зберегти звук вихідного відео.
seed	number	Ні	-	min 0 / max 2147483647	-	Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.

Політика завантаження

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

Правило референсів

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

Максимум файлів

Прийняті типи файлів

image, video

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kind	Максимальний розмір	MIME types
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/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.

API-інтеграція для Wan 2.7 Video