Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
face_enhance | Нет | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. По умолчанию: false |
face_mapping | Нет | Multi-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order. |
reference_image_url | Да | Reference face image. The facial features from this image are carried onto the person in the video. |
style | Нет | Готовый стиль или жанр. realistic · beautify · lossless · По умолчанию: realistic |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| Стандарт | 3,9 | 0,039 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Video Face Swap в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/face-swap-video-v1/video-edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-swap-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"style": "realistic"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Video Face Swap
Сколько стоит API Video Face Swap?
Video Face Swap стоит 3,9 кредита (0,039 $) за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Video Face Swap в API?
Укажите popnow/face-swap-video-v1/video-edit — Замена лица в видео в поле model запроса POST /jobs/createTask.
Чем это отличается от Face Swap?
Face Swap меняет статичное изображение. Video Face Swap выполняет такой же перенос черт лица на протяжении всего клипа, кадр за кадром. Референс в обоих случаях — статичное изображение.
Что куда передавать?
В video_url — клип, который меняется, в reference_image_url — фото с лицом. Одно — видео, другое — статичное изображение, так что случайно перепутать их нельзя.
Есть ли prompt, маска или seed?
Нет. Схема — это video_url, reference_image_url и необязательный style. Не нужно ничего формулировать и ничего закрашивать, а значит, исчезает целый класс сбоев из-за неоднозначных инструкций.
Какой style выбрать?
Начните с realistic по умолчанию: он сохраняет естественный тон и текстуру кожи. Beautify сглаживает и осветляет кожу. Lossless сохраняет максимум деталей референсного лица и хорошо подходит для крупных планов.
Какое видео подходит лучше всего?
Один человек в кадре, достаточно крупное лицо, ровный свет, и лицо надолго не отворачивается от камеры. Резкие профили, смаз от движения, руки перед лицом и очень мелкие лица ухудшают результат.
Можно попробовать Video Face Swap без кода?
Да. Playground запускает Video Face Swap на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Video Face Swap
- Face Swap Pro APIТочная замена лица с естественной текстурой кожиОт 24 кредитов за изображение
- Face Swap Plus APIЗамена лица с автоподбором тона кожиОт 24 кредитов за изображение
- Face Swap APIМеняет только лицо: причёска, поза и фон остаютсяОт 2 кредитов за изображение
- Video Face Swap APIОдно и то же лицо в каждом кадре клипаОт 3,9 кредита за секунду
