Face Swap Pro API

Модель переносит черты лица с одного изображения на человека на другом. Переносятся только черты: причёска, линия роста волос, силуэт головы, поза, одежда, свет и фон целевого кадра остаются прежними. Именно поэтому результат встраивается в исходную фотографию, а не лежит поверх неё.

Face Swap Pro — прецизионный уровень линейки Face Swap. Движок сам находит ключевые точки лица на обеих фотографиях и накладывает один набор на другой, а после этого к результату ничего не применяется. Весь запрос — два URL изображений: image_url для фотографии, которую меняют, и reference_image_url для лица, отправленные на spicyapi/face-swap-pro-v1/edit. Вызов асинхронный: он возвращает id задачи, вы опрашиваете эту задачу, а каждый запрос возвращает одно изображение с оплатой за каждое выходное изображение.

Движок совмещает лицо по ключевым точкам

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

Два URL изображений — и больше нечему ломаться

Это единственный эндпоинт замены лица в каталоге, который принимает только два изображения: ни промпта, ни области для маски, ни силы, ни seed. Это убирает целый класс ошибок из-за двусмысленных инструкций и делает пакетную обработку тривиальной: список пар проходит без решений по каждому элементу. Неизвестные ключи отклоняются, а не игнорируются, поэтому опечатка в имени поля даёт ошибку при отправке, а не тихий откат к значению по умолчанию. Действительно важно только одно — какой URL в какое поле: поля несимметричны, и если их поменять местами, запрос останется корректным, но результат будет совсем другим.

Целевая фотография переживает замену

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

Редакционные и рекламные кадры для печати

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

Замена человека в уже утверждённом кадре

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

Единый персонаж в серии

Сгенерируйте сцены любой моделью, а затем перенесите одно лицо во все, чтобы серия читалась как один и тот же человек. Волосы и одежда остаются от каждого целевого кадра, так что сгенерированное разнообразие сохраняется.

Кадры без цензуры: граница — согласие, а не тема

SpicyAPI не добавляет собственного контентного фильтра и не требует контентной отметки, поэтому тело запроса всегда состоит из тех же двух полей, что бы ни показывал кадр. Не смягчается разрешение: нужно явное и информированное согласие изображённого человека на именно это сходство в именно этом материале, и согласие никогда не подразумевается из-за того, что фотография публичная.

# 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-pro-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png"
  }
}'

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