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