Face Swap Plus API

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

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

Тон кожи выравнивается автоматически

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

Глубина вживления решается для каждой пары

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

Массовые конвейеры аватаров и фото профиля

Список пар «целевой кадр — референс» проходит через эндпоинт программно, по одному вызову на пару. Фиксируйте seed для пары, когда повторная попытка должна быть сопоставима с первым запуском, и выбирайте WebP, если результаты сразу идут в веб.

Пользовательские функции за формой загрузки

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

Каталоги и шаблоны

Одно и то же лицо-референс на серии заранее подготовленных кадров даёт цельную серию, не генерируя ни один из них заново. Настройка формата отдаёт файлы в том виде, которого уже ждёт ваш конвейер; любой аксессуар, который требует шаблон, должен быть в кадре до замены.

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

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-v1-plus/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "output_format": "jpeg",
    "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.