Введение
Video Face Swap переносит черты лица с одного референсного изображения на человека в видео — во всех кадрах клипа. Переносятся только черты лица: причёска, силуэт головы, движения, одежда, свет, работа камеры и фон остаются такими, какими были сняты. Поэтому результат выглядит как исходная съёмка, а не как наложенный поверх слой.
Video Face Swap принимает видеоклип и изображение референсного лица и переносит только черты лица на человека в кадре, сохраняя его волосы, движения, кадрирование и фон. Две ссылки и необязательная настройка вида — поля для prompt здесь нет вовсе.
Ключевые возможности и особенности
Сохранить исполнение, заменить идентичность лица
Face Swap переносит идентичность с утверждённого референса на человека в предоставленном видео, сохраняя живое исполнение. Выбирайте клип, где персонаж, кадрирование и свет уже работают: этот процесс заменяет идентичность, а не строит сцену заново.
Проверять непрерывность, а не синтетическую сцену
Оценивайте результат на обычной скорости во время поворотов, склеек и быстрых движений. Проверьте, что перенос выглядит связно, а волосы, движение, одежда и фон по-прежнему читаются как исходное видео.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип, который меняется. Волосы, форма головы, движения, одежда и вся сцена этого человека сохраняются — заменяются только черты лица. Не менее 1 символов |
reference_image_url | Да | Статичное изображение с чертами лица. Берётся только лицо, без волос и формы головы. Не менее 1 символов |
face_mapping | Нет | Для роликов с несколькими людьми: укажите, какое лицо с референса ставится на какое лицо в видео, по одной паре на элемент; лица нумеруются с 0 в порядке обнаружения. Не более 10 элементов |
face_enhance | Нет | Прогоняет заменённое лицо через улучшение, чтобы получить его в более высоком разрешении. По умолчанию выключено. По умолчанию: |
style | Нет | realistic (по умолчанию) сохраняет естественный тон и текстуру кожи; beautify сглаживает и осветляет кожу; lossless сохраняет максимум деталей референсного лица. |
Стоимость
$0.026 / секунда результата
Оплата взимается полными блоками по 10 секунд исходного клипа: клип длиной 12 секунд стоит столько же, сколько 20 секунд. Исходный клип должен длиться от 3 до 40 секунд; оценка перед отправкой рассчитывается по реальной длине загруженного клипа, а для ссылки на видео — по максимуму в 40 секунд, и разница, если есть, освобождается при списании.
Сценарии использования
Измените предоставленный клип
Video Face Swap переносит черты лица с одного референсного изображения на человека в видео — во всех кадрах клипа. Переносятся только черты лица: причёска, силуэт головы, движения, одежда, свет, работа камеры и фон остаются такими, какими были сняты. Поэтому результат выглядит как исходная съёмка, а не как наложенный поверх слой. Используйте этот режим, когда исходное видео должно оставаться основой для редактирования. Точно опишите изменение и проверьте непрерывность, тайминг и детали для сохранения.
Одно лицо на всю сгенерированную серию
Сгенерируйте серию клипов любой видеомоделью, а затем перенесите на все одно лицо, на которое есть согласие, чтобы вся серия читалась как один и тот же человек. Движения, одежда и декорации в каждом клипе свои, так что полученное при генерации разнообразие сохраняется.
Контент без цензуры с внешностью исполнителя, давшего согласие
Перенесите лицо, которое вы вправе использовать, на материал, снятый вами. Для контента без цензуры в запросе ничего не меняется, но требование о правах из ограничений ниже — жёсткое условие, а не формальность.
Замена исполнителя в уже удачном дубле
Оставьте дубль, где свет, мизансцена и движение камеры уже утверждены, и поставьте в него другое лицо, вместо того чтобы генерировать весь план заново и терять уже полученную игру.
Руководство по промптам и практические советы
Убедитесь, что у вас есть права на оба лица
Прежде всего технического: и в клипе, и на референсе люди, поэтому нужны права и на внешность, которую вы переносите, и на материал, в который её помещаете. Храните разрешение вместе с записью о задаче.
Разместите клип и лицо и отправьте их парой
video_url — материал, который меняется; reference_image_url — статичное изображение с лицом. Добавляйте style, только если вид realistic по умолчанию не подходит. Писать prompt не нужно.
Check the result before iterating
На референсе должно быть хорошо видимое, почти анфасное и хорошо освещённое лицо, а клип лучше всего работает с одним человеком, чьё лицо всё время остаётся достаточно крупным в кадре. Резкие ракурсы в профиль, смаз от быстрого движения, руки или предметы перед лицом и очень мелкие лица ухудшают перенос или приводят к сбою. Сильная разница в направлении света или тоне кожи между референсом и клипом проявляется на линии челюсти. Обрабатывается только одно лицо: если в кадре несколько человек, указать нужного нельзя. Здесь нет prompt, маски и seed: если результат не устраивает, помогает другой референс или другая нарезка материала, а не переформулированный запрос.
Быстрый старт 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": "spicyapi/face-swap-video-v1/video-edit",
"input": {
"reference_image_url": "https://example.com/reference.png",
"style": "realistic",
"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.
