Використовуйте Wan 3.0 Video через Rivya Public API v1 з ID моделі wan-3-0-video, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

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

ID моделі API

wan-3-0-video

Входи

text, file

Files API

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

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

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Можливість

Відео

Білінг

METERED

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

20000 символів

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

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

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

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

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
seedance_scene	select	Ні	text	-	text, frames, reference	Перед завантаженням медіа виберіть один взаємовиключний набір правил для входу.
variant	select	Ні	standard	-	standard, prime	Standard і Prime мають однакові елементи керування, але різні посекундні ставки.
resolution	select	Ні	1080P	-	480P, 720P, 1080P	Резерв дорівнює ставці варіанта й роздільності, помноженій на суму перевірених секунд вхідного відео та зарезервованих секунд виходу; підсумок один раз округлюється вгору. Розумна тривалість резервує 30 секунд виходу й недоступна з референсним відео.
aspect_ratio	select	Ні	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Виберіть адаптивне кадрування або одне фіксоване співвідношення сторін вихідного відео.
duration	number	Ні	5	min -1 / max 30 / step 1	-	Виберіть -1 для інтелектуальної тривалості або ціле число від 2 до 30 секунд. Інтелектуальна тривалість резервує 30 секунд вихідного відео й не може використовуватися з референсним відео.
audio	select	Ні	true	-	true, false	Виберіть, чи має згенероване відео містити створене моделлю аудіо.
seed	number	Ні	-	min 0 / max 2147483647 / step 1	-	Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.

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

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

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

Опорні кадри або підписані мультимодальні референси: Сценарій кадрів приймає обов’язкове перше зображення й одне необов’язкове останнє. Сценарій референсів приймає до 10 зображень JPEG, PNG без прозорості, WebP або BMP розміром до 20 MB кожне, 5 відео MP4/MOV розміром до 95 MB і тривалістю 1–15 секунд кожне та 5 аудіокліпів MP3/WAV розміром до 15 MB і тривалістю 1–15 секунд кожен; загальна тривалість відео й аудіо окремо обмежена 15 секундами.

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

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

image, video, audio

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

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

kind	Максимальний розмір	MIME-типи
image	20 MB	image/jpeg, image/png, image/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Мінімальний запит

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Запит із референсним файлом

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Відповідь створення

Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.

{
  "id": "task_wan_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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 3.0 Video