Skip to main content
POST
Wan 3.0 — универсальная генерация видео
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
Публичное имя модели Wan 3.0 — wan3.0-video. Одна модель поддерживает следующие режимы генерации:
  • Текст-в-видео
  • Управление первым кадром или первым и последним кадрами
  • Совместная генерация с референсными изображениями, видео и аудио
  • Референсы в виде файлов или публичных веб-страниц
API работает асинхронно. После успешной отправки возвращается ID задачи; используйте эндпоинт статуса видеозадачи для проверки прогресса и результатов.
Режим первого/последнего кадра и режим референсных материалов несовместимы.Если запрос содержит first_frame или last_frame, нельзя одновременно передавать референсные изображения, видео, аудио, файлы или веб-ссылки. Референсные изображения, видео и аудио можно комбинировать между собой.

Аутентификация

string
обязательно
Используется аутентификация Bearer Token:

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

string
по умолчанию:"wan3.0-video"
обязательно
Имя модели, фиксированное значение wan3.0-video.
string
Описание содержимого видео, движения объектов, ракурсов камеры и звука. Необходимо указать хотя бы prompt или медиаматериалы.При использовании мультимодальных референсов можно указывать в промпте «изображение 1», «видео 1», «аудио 1» в порядке элементов массива.
integer
по умолчанию:"5"
Длительность выходного видео, от 2 до 30 секунд. Передайте -1 для умного режима — модель сама подберёт длительность по промпту и материалам.
string
по умолчанию:"adaptive"
Соотношение сторон выходного видео. Поддерживаются:
  • adaptive — автоматический подбор по референсным материалам
  • 16:9
  • 9:16
  • 1:1
  • 4:3
  • 3:4
Также можно использовать совместимое поле aspect_ratio. Передавать оба поля одновременно не нужно.
string
по умолчанию:"1080p"
Разрешение выходного видео: 480p, 720p и 1080p.
boolean
по умолчанию:true
Генерировать ли аудиодорожку. Включено по умолчанию.
boolean
по умолчанию:false
Добавлять ли водяной знак. Отключено по умолчанию.
integer
Необязательное зерно генерации. Одинаковые параметры и seed помогают воспроизвести похожий результат.
object[]
Массив управления первым/последним кадром. Каждый элемент содержит:
  • url: публично доступный URL изображения
  • role: first_frame или last_frame
Можно указать не более одного первого и одного последнего кадра. При использовании last_frame обязательно укажите first_frame.
string[]
Массив URL референсных изображений, до 10 штук. Нельзя комбинировать с первым/последним кадром в image_with_roles.
object[]
Массив референсных видео, до 5 роликов общей длительностью не более 15 секунд. Каждый элемент имеет структуру:
object[]
Массив референсных аудио, до 5 дорожек общей длительностью не более 15 секунд. Каждый элемент содержит:
  • url: публично доступный URL аудио
  • role: фиксированное значение reference_audio
object
Референсы файлов или веб-страниц передаются через metadata.media.
Локальные изображения и видео необходимо сначала загрузить и получить публичный URL. Не передавайте локальные пути к файлам или данные base64 напрямую в запросе на генерацию.

Правила комбинирования материалов

Если вы получили следующую ошибку:
Удалите первый/последний кадры и оставьте референсные материалы; либо удалите все референсные материалы и оставьте только первый/последний кадры.

Примеры запросов

Текст-в-видео

Генерация видео по первому и последнему кадрам

Генерация видео по референсному видео

Не передавайте first_frame или last_frame в этом запросе.

Комбинированные референсы: изображение, видео и аудио

Референс файла

Ответ

string
ID видеозадачи, используется для проверки статуса.
string
Тип объекта, обычно generation.task.
string
Имя модели, использованной в этом запросе.
string
Статус задачи: queued, in_progress, completed или failed.
integer
Прогресс задачи, от 0 до 100.
integer
Временная метка создания задачи.