Skip to main content
POST
Генерация видео
Создаёт задачу генерации видео и возвращает её task_id.

Заголовки

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

Отдельного поля для выбора режима нет: модель определяет его сама по промпту и переданным материалам.
  • Текст → видео — только prompt.
  • Генерация по референсам — prompt вместе с images, videos и/или audios. Модель переносит в видео персонажей, предметы, окружение, движение и голос из референсов.
  • Редактирование видео — prompt с описанием правки и исходное видео в videos.
  • Продолжение видео — prompt с описанием того, что происходит дальше, и исходное видео в videos.
В промпте можно ссылаться на материалы по их порядку в списке: «персонаж с изображения 1 садится на стул с изображения 2», «человек из видео 1 говорит…». Нумерация в каждом поле своя и начинается с 1.

Ограничения

  • duration — целое число от 2 до 30 секунд.
  • images — не более 10 изображений.
  • videos — не более 5 видео общей длительностью не более 15 секунд.
  • audios — не более 5 аудиофайлов общей длительностью не более 15 секунд.
  • Суммарная длительность входных видео и duration — не более 30 секунд. Например, с входным видео на 12 секунд можно запросить не больше 18 секунд результата.
  • В videos должны быть именно видеофайлы: аудиофайл без видеодорожки будет отклонён.
  • Все URL должны быть публично доступны без авторизации.

Ответ

Задача создаётся сразу, а параметры проверяются уже в процессе её выполнения. Если запрос не прошёл проверку, задача завершится со статусом rejected и описанием причины (см. Ошибки). Ошибки авторизации, неизвестной модели и отсутствия доступа по группе ключа возвращаются сразу с HTTP-кодом ошибки; задача в этом случае не создаётся.

Примеры

Текст → видео

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

Редактирование видео

Продолжение видео

Authorizations

Authorization
string
header
required

Заголовок Authorization: Bearer <ваш API-ключ>.

Body

application/json
model
enum<string>
required

Обе модели имеют одинаковые возможности и ограничения; prime генерирует быстрее.

Available options:
wan-3,
wan-3-prime
Example:

"wan-3"

prompt
string
required

Непустое текстовое описание желаемого видео. На материалы можно ссылаться по порядку: «изображение 1», «видео 1» и т. д. Нумерация в каждом поле начинается с 1.

Minimum string length: 1
Example:

"Красивый закат над морем"

duration
integer
default:5

Длительность итогового видео в секундах. Суммарная длительность входных видео и duration не должна превышать 30 секунд.

Required range: 2 <= x <= 30
Example:

5

size
enum<string>
default:480p

Разрешение итогового видео.

Available options:
480p,
720p,
1080p
Example:

"720p"

aspect_ratio
enum<string>

Если не передано, подбирается автоматически под промпт и референсы.

Available options:
16:9,
9:16,
4:3,
3:4,
1:1
Example:

"16:9"

images
string<uri>[]

URL референс-изображений, до 10 штук. URL должны быть публично доступны без авторизации.

Maximum array length: 10
Example:
videos
string<uri>[]

URL референс-видео, до 5 штук общей длительностью не более 15 секунд. В каждом файле должна быть видеодорожка. URL должны быть публично доступны без авторизации. Сумма длительности входных видео и duration не должна превышать 30 секунд.

Maximum array length: 5
Example:
audios
string<uri>[]

URL референс-аудио, до 5 штук общей длительностью не более 15 секунд. URL должны быть публично доступны без авторизации.

Maximum array length: 5
Example:

Response

200 - application/json

Задача создана

task_id
string
required

Идентификатор задачи для последующего опроса через fetch.

Example:

"b22c9ae2-0b55-4398-88df-0191aae664f0"