Введение
Передайте video_url и reference_image_urls, затем выберите разрешение от 480p до 4K. Используйте prompt, если нужно указать, кого заменить. В наших тестах результатом был MP4 с частотой 24 fps и сохранением измеренной длительности исходника.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Издатель | Pruna AI |
| Входное видео | MP4, MOV или WebM; до 8K |
| Длительность источника | 1–120 секунд; более длинные видео обрезаются на 120 секундах |
| Фотореференсы | 1 или 2; по одному человеку на фотографии |
| Уровни разрешения | 480p, 768p (по умолчанию), 1080p, 2K, 4K; последние три — апскейл из 768p |
| Формат и частота кадров результата | MP4, 24 fps в наших тестах |
| Длительность и пропорции результата | В наших тестах длительность и соотношение сторон исходника сохранились |
| Звук | Исходная звуковая дорожка сохраняется по умолчанию; её можно удалить. По заявлению Pruna, артикуляция следует исходному звуку, если он не игнорируется. |
Ключевые возможности и особенности
Укажите, какого велосипедиста заменяет каждое фото
В наших тестах prompt назначал первое фото велосипедисту в синем, а второе — велосипедисту в красном. В результате рядом с мужчиной в белой рубашке появилась героиня комикса в коричневой куртке и брюках карго. Трамвай, улица и движение камеры сохранились в сцене.
Пусть движения задаёт сольное исполнение
В наших тестах один референс заменил студийную танцовщицу темноволосой женщиной в чёрной рубашке. Поле prompt в запросе оставалось пустым. Танцевальные движения следовали исходнику, а серая студия сохранилась.
Настраивайте дорожку и влияние звука отдельно
Два переключателя звука решают разные задачи. keep_original_audio сохраняет запись в готовом файле. ignore_source_audio определяет, учитывает ли модель эту запись; по заявлению Pruna, это позволяет согласовать с ней артикуляцию нового персонажа. В наших тестах отключение сохранения звука удаляло звуковую дорожку.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Обязательное исходное видео MP4, MOV или WebM, 1–120 секунд, до 8K. Более длинный ролик обрезается на 120 секундах. Не менее 1 символов |
reference_image_urls | Да | Обязательно: одна или две фотографии, по одному человеку на каждой. Не менее 1 элементов · Не более 2 элементов |
prompt | Нет | Необязательные указания: кого выбрать в исходнике, кому назначить каждое фото и что сохранить. Не более 2000 символов |
resolution | Нет | Выберите 480p или 768p (по умолчанию) для прямой генерации. 1080p, 2K и 4K получаются апскейлом результата 768p и требуют больше времени. |
keep_original_audio | Нет | По умолчанию включён для сохранения исходной записи. В наших тестах его отключение давало результат без звуковой дорожки. По умолчанию: |
ignore_source_audio | Нет | По умолчанию выключен, позволяя модели учитывать исходный звук. По заявлению Pruna, он задаёт артикуляцию нового персонажа. По умолчанию: |
seed | Нет | Необязательное целое число для сравнения вариантов при изменении одного входного значения. Повторное использование не гарантирует, что каждый кадр совпадёт с предыдущим запуском. |
Стоимость
Оплата рассчитывается по длительности исходного ролика с округлением вверх до целых секунд: минимум 1 секунда, максимум 120 секунд. Ставка зависит от выбранного разрешения. Количество фото, текст prompt и оба переключателя звука на неё не влияют. Неудачные задачи не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.06 / секунду |
| $0.12 / секунду |
| $0.144 / секунду |
| $0.168 / секунду |
| $0.216 / секунду |
Сценарии использования
Проверка актёрского состава на готовом видео
С согласия актёра примените фото для замены к уже снятой сцене и оцените новый образ в записанном исполнении.
Новая пара в уличной сцене
Назначьте велосипедистам два референса по цвету рубашек и посмотрите, как выглядят новые персонажи на протяжении кадра с движущейся камерой.
Образ персонажа для сольного танца
Примените референс персонажа, на который у вас есть разрешение, к студийному ролику танцора и сравните причёску и одежду на протяжении номера.
Руководство по промптам и практические советы
Подтвердите согласие и права на фото
Получите согласие человека на такое использование и проверьте свои права на фотографию. Перед первым запуском на странице модели примите условия использования внешности.
Добавьте видео и фотографии для замены
Выберите MP4, MOV или WebM длительностью от 1 до 120 секунд. Добавьте одну или две фотографии, на каждой — один человек. При одном фото заменяется главный участник сцены.
Распределите роли и настройте звук
Для двух людей укажите в prompt соответствие между каждым участником исходной сцены и фотографией либо используйте автоматическое сопоставление слева направо. Выберите разрешение и решите, сохранять ли звук и использовать ли его для артикуляции.
Проверьте и сохраните результат
Сравните внешность нового исполнителя, его действия и звуковую дорожку с исходником. Скачайте готовый файл в течение 14 дней, пока он не удалён.
Введение
P-Video 2 Pro Replace от Pruna AI использует готовое видео и одну или две фотографии, чтобы заменить исполнителей. Подготовьте ролик MP4, MOV или WebM длительностью от 1 до 120 секунд и по фото на каждую замену. До отправки получите согласие на использование внешности каждого человека и проверьте права на фотографии. Не используйте знаменитостей, публичных персон, знакомых или изображения, на которые у вас нет прав. Перед первым запуском страница модели предложит принять условия использования внешности.
По заявлению Pruna, при редактировании сохраняются движение камеры, композиция кадра, фон, другие люди, хронометраж и движения, а новый персонаж повторяет исходное исполнение. Длительность и соотношение сторон определяются исходником; отдельных настроек для них нет. В наших тестах исходники длительностью 5,04 и 2,00 секунды дали MP4 той же длительности с частотой 24 fps. Референс может изменить одежду и причёску вместе с внешностью.
Основные возможности и особенности
- Одна или две замены: Одно фото применяется к главному участнику. Два фото сопоставляются слева направо, если в prompt не задано другое соответствие.
- Исходное видео до 120 секунд: Входное разрешение может достигать 8K. Всё после отметки 120 секунд обрезается.
- Пять вариантов разрешения: 480p и стандартное 768p генерируются напрямую. Для 1080p, 2K и 4K Pruna увеличивает результат 768p: обработка дольше, но новых деталей модель не создаёт.
- Раздельные настройки звука:
keep_original_audioпо умолчанию сохраняет звуковую дорожку.ignore_source_audioпо умолчанию выключен, чтобы модель могла использовать звук для артикуляции, как описывает Pruna. - Проверен рисованный референс: В наших тестах причёска, куртка и брюки карго героини комикса перенеслись в видео с велосипедистами.
- Измеренные примеры обработки: В наших тестах обработка 2-секундного исходника заняла 47 секунд при 480p и 160 секунд при 4K. Для 5-секундного исходника при 768p потребовалось 60–90 секунд. Это наблюдения, а не гарантированные сроки.
Сценарии применения
- Предпросмотр согласованной замены актёра: Примените фото актёра с его разрешения к готовой сцене и оцените другой образ в записанном исполнении.
- Распределение ролей между велосипедистами: Добавьте два фото и обозначьте каждого велосипедиста по цвету рубашки, затем проверьте соответствия и сравните улицу с трамваем с исходником.
- Персонаж в танцевальном номере: Добавьте один референс персонажа для сольного танца и оцените изменённую причёску и костюм на протяжении студийного выступления.
Работа с prompt и практические советы
- Упростите запрос для одного исполнителя: Если в кадре один человек, оставьте prompt пустым; рабочая инструкция — «replace the main person». В нашем примере сольного танца prompt не понадобился.
- Ясно сопоставьте оба референса: Укажите исходную одежду и порядок фото, например: «blue-shirt rider: first photo; red-shirt rider: second photo». Это заменяет автоматическое сопоставление слева направо.
- Укажите, что нужно сохранить: Добавьте короткую инструкцию, например: «keep the other people and street unchanged». Pruna описывает исходную сцену как основу редактирования.
- Отдельно выберите поведение звука: Для инструкции «keep the dialogue and follow its timing» оставьте
keep_original_audioвключённым, аignore_source_audio— выключенным. Чтобы сохранить звук без его влияния на артикуляцию, включитеignore_source_audio. - Сравнивайте по одному изменению за запуск: Используйте целое число seed при проверке указания вроде «second photo replaces the rider in red». seed помогает сравнивать варианты в контролируемых условиях, но не обещает идентичных кадров.
- Проверьте результат до апскейла: Оцените стандартный результат 768p с указанием вроде «preserve the studio setting». Выбирайте 1080p, 2K или 4K, если нужна увеличенная версия и есть время на дополнительную обработку.
Получите согласие на использование внешности любого человека, чьё изображение отправляете, и проверьте права на фотореференс. Не используйте знаменитостей, публичных персон, знакомых или фото без прав на использование. Перед первым запуском на странице модели необходимо принять условия использования внешности. Честно сообщайте, что видео отредактировано.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-video-2-pro-replace/video-edit",
"input": {
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "768p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.

