Skip to main content
Модель заменяет в исходном видео выбранный объект — предмет, одежду, продукт — на объект с референсных изображений. Остальной кадр, движение, работа камеры и тайминг сохраняются. Длительность результата совпадает с длительностью исходного видео.

​
Группа ключей

Для использования модели необходим API-ключ с группой default.

​
Тарификация

Цена считается за каждую секунду исходного видео и зависит от разрешения результата (size). Длительность округляется вверх до целой секунды.
Например, исходное видео длиной 7.2 секунды в разрешении 720p стоит 8 × $0.4 = $3.20. Списание происходит только за задачи со статусом completed.

​
Входные данные

  • videos — ровно одна ссылка на исходное видео. Длительность — от 4 до 30 секунд.
  • images — от 1 до 8 ссылок на референсные изображения объекта, который нужно подставить.
  • prompt — необязательное текстовое описание, например какой объект заменить, до 10 000 символов.
  • size — разрешение результата: 480p, 720p или 1080p. По умолчанию 720p.
Все ссылки должны быть публично доступны по HTTP(S) без авторизации.

​
Статусы задачи

Параметры запроса проверяются уже после создания задачи. Если вход невалиден, /v1/videos/generations всё равно вернёт task_id, а задача получит статус rejected.

​
В поле error задачи

  • BadRequest — невалидные параметры: число видео или изображений, длительность исходного видео, разрешение и т. п. Подробности — в поле message.
  • ContentRejected — исходное видео, референсы или результат отклонены модерацией.
  • UnknownError — внутренняя ошибка (статус failed).