P-Video 2 Pro Replace: руководство по началу работы — замена людей в видео с помощью 1–2 фотографий

P-Video 2 Pro Replace — это модель замены людей в видео от Pruna AI: вы передаёте ей исходное видео и 1–2 фотографии человека, и она сохраняет движение, ракурс камеры, сцену и звук исходного видео, заменяя человека в кадре на человека с фотографии. В этой статье подробно рассказывается, что модель умеет, как её вызывать, как рассчитывается стоимость и когда стоит выбрать другую модель.

Что она умеет

• Замена человека по одному видео и одной фотографии: обязательны только исходное видео video_url и фотография человека image_urls, предварительное обучение образа не требуется.
• Замена максимум двух людей: в image_urls передаётся 1–2 фотографии (jpg, jpeg, png, webp), по одной на человека; при двух людях — по одной каждой.
• Всё из исходного видео сохраняется: движения, движение камеры, сцена и длительность следуют исходному видео. keep_audio включён по умолчанию, и выходное видео содержит звук исходного; при значении false выходное видео будет без исходного звука.
• Пять уровней разрешения: 480p, 768p, 1080p, 2k, 4k, по умолчанию 768p, с сохранением соотношения сторон исходного видео.
• Необязательный промпт: prompt (до 1000 символов) описывает, как человек с фотографии должен быть помещён в кадр; можно не указывать.

Требования к входным данным

• Исходное видео: MP4, MOV или WebM, длительностью 2–30 секунд. Видео вне этого диапазона отклоняются при отправке без списания средств; более длинные материалы следует сначала обрезать до фрагментов не длиннее 30 секунд.
• Фотографии человека: 1–2 штуки, HTTPS-ссылки.
• Фильтрация контента по безопасности включена по умолчанию; при нарушении задача завершается ошибкой с кодом CONTENT_POLICY_VIOLATION, а средства возвращаются в полном объёме.

Как вызвать

Отправьте асинхронную задачу и после получения taskId опрашивайте результат:

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "p-video-2-pro-replace",
    "input": {
      "video_url": "https://example.com/source.mp4",
      "image_urls": ["https://example.com/person.jpg"],
      "resolution": "768p",
      "keep_audio": true
    }
  }'

curl https://api.hiapi.ai/v1/tasks/<taskId> \
  -H "Authorization: Bearer $HIAPI_KEY"

После успешного выполнения задачи в output будет адрес видео, длительность совпадает с исходным видео.

Цены

Оплата взимается по длительности выходного видео, неполные секунды не тарифицируются; цена одинакова для одной и двух фотографий:

• 480p: $0.0358/сек
• 768p: $0.0715/сек
• 1080p: $0.0858/сек
• 2k: $0.1000/сек
• 4k: $0.1286/сек

Например, 10-секундное видео 768p обойдётся примерно в $0.72, а 30-секундное 480p — примерно в $1.07. При отправке предварительно списывается сумма за 30 секунд, после завершения расчёт производится по фактической длительности видео, а излишек возвращается. За неудачные задачи средства возвращаются в полном объёме.

Как использовать эффективнее

• Чем чётче человек и плавнее движения в исходном видео, чем яснее лицо анфас и ровнее освещение на фотографии, тем стабильнее результат замены.
• Сначала проверьте результат на коротком фрагменте в 480p, затем создавайте финальное видео в высоком разрешении.
• Если нужен воспроизводимый результат, передайте seed (целое число от 0 до 2147483647); вместе с одинаковыми входными данными это помогает воспроизвести результат.

Когда выбрать другое

• Если нужно изменить стиль изображения, сцену или ракурс камеры: эта модель только заменяет людей, всё остальное следует исходному видео, поэтому выбирайте модели редактирования видео.
• Если нет исходного видео, а есть только портрет и текст реплики: используйте P-Video 2 Pro Avatar из той же серии для создания видео с говорящим человеком.

Чтобы сразу попробовать результат, загрузите короткое видео и фотографию человека в HiAPI Playground и выполните генерацию.