PopNow APIpopnow.ai
Получить API-ключ

от PopNow

Замена лица с автоподбором тона кожи

popnow/face-swap-v1-plus/editОт 24 кредитовза изображение · 0,24 $
Попробовать в PlaygroundПолучить API-ключ
  • Замена лица

О модели Face Swap Plus

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

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

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

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

ПараметрОбязательныйОписание
image_urlДаКартинка, с которой всё начинается.
output_formatНетФормат файла результата. png · jpeg · webp · По умолчанию: jpeg
output_qualityНетRequested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · По умолчанию: 95
promptНетOptional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
reference_image_urlДаReference face image. The facial identity from this image is transferred onto the target.
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647

Цены

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

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

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

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

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

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

# 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 Plus

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

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

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

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

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

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

Есть поле `prompt`. Оно что-нибудь делает?

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

Гарантирует ли фиксированный seed одинаковый результат?

Нет. Он даёт двум прогонам по одной паре одну и ту же выборку, из-за чего сравнение становится честным, когда вы меняете ровно одну вещь. Это инструмент сравнения, а не обещание побайтово одинакового изображения.

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

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

Какие ограничения у API Face Swap Plus?

Длина промпта (символов): 200. Запросы за пределами этих ограничений отклоняются до любого списания.

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

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

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

Ещё о Face Swap Plus