Wan3.0
Генерация видео Wan3.0
- Универсальная референс-модель видео Alibaba Cloud Wanxiang 3.0 (единая точка входа)
- Текст-в-видео / первый кадр / первый+последний кадр / мультимодальный референс / файл или веб-страница
- Разрешение 480P / 720P / 1080P, длительность 2–30 секунд
- Поддержка изображений, видео, аудио, документов и публичных веб-страниц как референсов
POST
Авторизация
string
обязательно
Все эндпоинты требуют аутентификации по Bearer TokenПолучите API Key на странице управления API Key:
Режимы генерации
Имя модели фиксировано:wan3.0-video. Режим выбирается по полям запроса:
Параметры запроса
Базовые
string
обязательно
Фиксированное значение:
wan3.0-videostring
Текстовое описание. Обязательно, если не переданы медиа-поля (нужно хотя бы одно: prompt или медиа).
- Максимум 20 000 символов; превышение обрезается автоматически (без ошибки)
- В режиме референса используйте «图N / 视频N / 音频N» для обращения к активам; индексы идут внутри каждого типа медиа
string
по умолчанию:"1080P"
Выходное разрешение (без учёта регистра)
480P720P1080P(по умолчанию, самая высокая цена)
string
по умолчанию:"adaptive"
Соотношение сторон. Также принимается
aspect_ratio.adaptive(по умолчанию)16:9/4:3/1:1/3:4/9:16
integer
по умолчанию:"5"
Длительность в секундах, 2–30, по умолчанию
5При входном референсном видео: суммарная длительность входного видео + выходной
duration должна быть ≤ 30 секунд.boolean
по умолчанию:"true"
Включать ли аудиодорожку в выход. По умолчанию
true. Цена одинакова с аудио и без.integer
Случайное зерно в диапазоне
[0, 2147483647]boolean
по умолчанию:"false"
Добавлять ли водяной знак. По умолчанию
falsestring
Как классифицировать «голые»
image_urls:frame— семейство первого/последнего кадраreference— семейство референсов
Медиа-входы
string[]
Массив URL изображений. Роли назначаются по правилам взаимного исключения.Публичный URL или Base64 (
data:image/png;base64,...).object[]
Изображения с явными ролями. Каждый элемент:
url: адрес изображенияrole:first_frame/last_frame/reference_image(принимаются распространённые псевдонимы)
string[]
Референсные видео, до 5 клипов; каждый 1–15 с, суммарно ≤ 15 с
string[]
Референсное аудио, до 5 клипов; каждый 1–15 с, суммарно ≤ 15 с
string
Одно референсное аудио (одиночная форма
audio_urls)string
URL референсного документа, не более 1. Нельзя сочетать с
link_url.Форматы: docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md и др., ≤100 МБ, ≤50 страниц.string
URL публичной веб-страницы, не более 1. Только страницы без входа. Нельзя сочетать с
file_url.Взаимное исключение семейств медиа
Медиа относится к одному из двух семейств и не должно смешиваться (проверка до submit → 400, без задачи и без списания):Как назначаются «голые» image_urls
- Если задан
generation_type→ использовать его (frame/reference) - Иначе, если в запросе уже есть входы семейства референсов (
video_urls/audio_urls/audio_url/file_url/link_url) → считатьreference_image - Иначе → семейство кадров: первый элемент
first_frame, второйlast_frame(как уwan2.7)
image_with_roles.
Лимиты и форматы медиа
Примеры запросов
Текст-в-видео
Видео по первому кадру
Первый + последний кадр
image_with_roles:
Мультимодальный референс
При наличииvideo_urls«голые»image_urlsавтоматически относятся к референсным изображениям; явноеgeneration_type: "reference"делает намерение яснее.
Видео по файлу
prompt можно опустить; генерация идёт по содержимому документа:
Видео по веб-странице
Тарификация
За секунду × разрешение (по официальному прайс-листу). Вкл./выкл. аудио цену не меняет:- По умолчанию 1080P (самый дорогой); при чувствительности к стоимости передавайте
480P/720P - Тарифицируемые секунды = запрошенный
duration audio: true/falseне влияет на цену
Ограничения и замечания
Частые ошибки
Все — синхронный 400 (без задачи, без списания):Response
integer
Код статуса; 200 при успехе
array
Массив данных ответа
Запрос результатовГенерация видео асинхронна. Опрашивайте Получение статуса задачи или
GET /v1/videos/generations/{task_id}.Рекомендуемый интервал 5–10 секунд; генерация обычно занимает 1–5 минут. При успехе используйте URL из result.videos.