popnow
ВойтиСоздавать

popnow/face-swap-pro-v1/editОт 24 кредитов за изображение

Face Swap Pro — точная ступень линейки Face Swap: он находит на обоих снимках ключевые точки лица и сопоставляет лицо по ним, а приукрашивающего прохода по результату нет, поэтому исходная фактура сохраняется. Весь запрос — два адреса изображений, ничего не нужно формулировать и настраивать, а на каждый вызов возвращается одно изображение с оплатой за выходное изображение.

Вызывайте его по имени модели popnow/face-swap-pro-v1/edit через POST /jobs/createTask, от 24 кредита за изображение (0,24 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.

  • Замена лица
от PopNowПолучить API-ключFace Swap Pro: примеры и промпты →

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
face_enhanceНетRun a face-enhancement pass on the swapped face for a sharper, more detailed result. По умолчанию: false
image_urlДаКартинка, с которой всё начинается.
reference_image_urlДаReference face image. The facial features from this image are transferred onto the target.

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

ВариантКредиты за изображение≈ USD
Стандарт240,24 $

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API Face Swap Pro в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/face-swap-pro-v1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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-pro-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp"
  }
}'

# 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 Face Swap Pro

Сколько стоит API Face Swap Pro?

Face Swap Pro стоит 24 кредита (0,24 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у Face Swap Pro в API?

Укажите popnow/face-swap-pro-v1/edit — Замена лица в поле model запроса POST /jobs/createTask.

Какое изображение класть в image_url?

То, которое меняется. Лицо отдаёт reference_image_url. Менять их местами нельзя: перепутанный запрос остаётся корректным и просто даёт совершенно другой результат, поэтому ошибка ничем не отловится.

Есть ли промпт или маска?

Нет. Запрос — два URL изображений. Нечего формулировать и негде закрашивать область, а значит, исчезает целый класс отказов из-за неоднозначной инструкции.

Почему здесь нельзя зафиксировать seed?

Движок за этим эндпойнтом его не принимает, и выставить поле означало бы напечатать регулятор, который никто не исполнит. Когда два прогона по одной паре должны остаться сопоставимыми, seed принимают и Face Swap, и Face Swap Plus.

Какими должны быть два изображения?

На каждом — одно хорошо различимое лицо, более или менее анфас, в фокусе и достаточно крупно в кадре, чтобы черты читались, в формате JPEG, PNG или WebP. Групповой снимок перед отправкой кадрируйте до одного человека. Самый полезный рычаг — направление света: референс, освещённый примерно с той же стороны, что и цель, избавляет от шва по челюсти, потому что замена не меняет свет цели.

Можно попробовать Face Swap Pro без кода?

Да. Playground запускает Face Swap Pro на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

Все модели Face Swap Pro

Ещё о Face Swap Pro