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 레퍼런스에서 확인하세요.