Skip to main content
POST

Авторизация

string
обязательно
Все эндпоинты требуют аутентификации по Bearer TokenПолучите API Key на странице управления API Key:

Режимы генерации

Имя модели фиксировано: wan3.0-video. Режим выбирается по полям запроса:

Параметры запроса

Базовые

string
обязательно
Фиксированное значение: wan3.0-video
string
Текстовое описание. Обязательно, если не переданы медиа-поля (нужно хотя бы одно: prompt или медиа).
  • Максимум 20 000 символов; превышение обрезается автоматически (без ошибки)
  • В режиме референса используйте «图N / 视频N / 音频N» для обращения к активам; индексы идут внутри каждого типа медиа
string
по умолчанию:"1080P"
Выходное разрешение (без учёта регистра)
  • 480P
  • 720P
  • 1080P (по умолчанию, самая высокая цена)
Если не указать resolution, тарификация идёт по 1080P. При чувствительности к стоимости явно передавайте 480P или 720P.
string
по умолчанию:"adaptive"
Соотношение сторон. Также принимается aspect_ratio.
  • adaptive (по умолчанию)
  • 16:9 / 4:3 / 1:1 / 3:4 / 9:16
integer
по умолчанию:"5"
Длительность в секундах, 2–30, по умолчанию 5
duration: -1 (умная длительность) не поддерживается. Передавайте целое число от 2 до 30.
При входном референсном видео: суммарная длительность входного видео + выходной duration должна быть ≤ 30 секунд.
boolean
по умолчанию:"true"
Включать ли аудиодорожку в выход. По умолчанию true. Цена одинакова с аудио и без.
integer
Случайное зерно в диапазоне [0, 2147483647]
boolean
по умолчанию:"false"
Добавлять ли водяной знак. По умолчанию false
string
Как классифицировать «голые» 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 страниц.
URL публичной веб-страницы, не более 1. Только страницы без входа. Нельзя сочетать с file_url.

Взаимное исключение семейств медиа

Медиа относится к одному из двух семейств и не должно смешиваться (проверка до submit → 400, без задачи и без списания):

Как назначаются «голые» image_urls

  1. Если задан generation_type → использовать его (frame / reference)
  2. Иначе, если в запросе уже есть входы семейства референсов (video_urls / audio_urls / audio_url / file_url / link_url) → считать reference_image
  3. Иначе → семейство кадров: первый элемент 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.