Интеграция Wan 3.0 Video API
Используйте Wan 3.0 Video через Rivya Public API v1: ID модели wan-3-0-video, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
wan-3-0-video
text, file
Требуется для референсных режимов
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 МБ, 5 видео MP4/MOV по 95 МБ и длительностью 1–15 секунд и 5 аудиоклипов MP3/WAV по 15 МБ и длительностью 1–15 секунд; суммарная длительность видео и аудио отдельно ограничена 15 секундами.
20
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.