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

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

Face Swap берёт целевое изображение и референсное лицо и переносит только черты лица. Форма головы, причёска, поза и фон цели сохраняются. На входе две ссылки и необязательный seed: поля prompt здесь нет вовсе.

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

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

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

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

ПараметрОбязательныйОписание
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.
image_urlДаКартинка, с которой всё начинается.
reference_image_urlДаReference face image. The facial features from this image are transferred onto the target.
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647
styleНетГотовый стиль или жанр. realistic · beautify · lossless · По умолчанию: realistic

Цены

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

ВариантКредиты за изображение≈ USD
Стандарт1,950,02 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 2 кредита за изображение (0,02 $).

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

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

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

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/face-swap-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-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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 Face Swap

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

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

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

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

Чем Face Swap отличается от Head Swap?

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

Какое изображение идёт в image_url?

То, которое меняют. reference_image_url отдаёт лицо. Местами они не меняются, а перестановка допустима и даёт совсем другой результат — ошибки, которая на это укажет, не будет.

Есть ли prompt или маска?

Нет. В схеме только image_url, reference_image_url и seed. Формулировать нечего и область рисовать не надо, поэтому целый класс отказов из-за размытой инструкции исчезает.

Какие исходные фотографии работают лучше всего?

Хорошо различимые, более-менее фронтальные, нормально освещённые лица приличного размера в кадре, со схожим направлением света на обоих снимках. Профили, смаз, сильное перекрытие и крошечные лица — там качество падает.

Справится ли он с несколькими лицами на фото?

Нет. Рабочее допущение — одно лицо на изображение, а групповой кадр не даёт эндпоинту понять, кого вы имели в виду. Обрежьте до субъекта перед отправкой.

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

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

Все модели Face Swap

Ещё о Face Swap