Face Swap Pro 소개
Face Swap Pro는 Face Swap 계열의 정밀 등급입니다. 두 사진에서 얼굴 특징점을 찾아 얼굴을 대응시키고, 결과물 위로 보정이 지나가지 않아 원래 질감이 그대로 남습니다. 요청 전체는 이미지 URL 두 개뿐이라 다듬을 문장도 조절할 손잡이도 없으며, 호출 한 번에 이미지 한 장이 돌아오고 과금은 출력 이미지 단위입니다.
POST /jobs/createTask에서 모델 이름을 popnow/face-swap-pro-v1/edit(으)로 지정하면 호출할 수 있습니다. 24크레딧/장부터(US$0.24). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
face_enhance | 아니요 | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. 기본값: false |
image_url | 예 | 출발점이 되는 이미지. |
reference_image_url | 예 | Reference face image. The facial features from this image are transferred onto the target. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 24 | US$0.24 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Face Swap Pro API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/face-swap-pro-v1/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 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-pro-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp"
}
}'
# 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"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Face Swap Pro API 질문
Face Swap Pro API 요금은 얼마인가요?
Face Swap Pro 가격은 24크레딧(US$0.24) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Face Swap Pro의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 얼굴 바꾸기: popnow/face-swap-pro-v1/edit을(를) 넣으세요.
image_url에는 어느 이미지를 넣습니까?
바뀌는 쪽입니다. 얼굴을 주는 쪽은 reference_image_url입니다. 두 항목은 서로 바꿔 넣을 수 없습니다. 뒤바꿔도 요청 자체는 유효하고 결과만 완전히 달라지므로, 이 실수를 잡아 주는 오류는 나오지 않습니다.
prompt나 마스크가 있습니까?
없습니다. 요청은 이미지 URL 두 개입니다. 쓸 문장도 칠할 영역도 없으니 모호한 지시에서 생기는 실패가 통째로 사라집니다.
여기서는 왜 seed를 고정할 수 없습니까?
이 엔드포인트 뒤에 있는 엔진이 seed를 받지 않기 때문입니다. 항목만 내보내면 아무도 이행할 수 없는 조절 장치를 내걸게 됩니다. 같은 짝으로 두 번의 실행을 비교하고 싶을 때는 Face Swap과 Face Swap Plus가 모두 seed를 받습니다.
두 이미지는 어떤 사진이어야 합니까?
각각 얼굴 하나가 또렷하게 보이고, 심한 측면이 아니며, 초점이 맞고, 이목구비가 읽힐 만큼 크게 담겨야 하며 형식은 JPEG, PNG, WebP 중 하나입니다. 단체 사진은 보내기 전에 한 사람으로 잘라 내십시오. 통제할 수 있는 것 중 가장 효과가 큰 것은 빛의 방향이며, 타깃과 대략 같은 쪽에서 빛을 받은 레퍼런스라면 턱선 이음매를 피할 수 있습니다. 교체가 타깃의 빛을 바꾸지 않기 때문입니다.
코드 없이 Face Swap Pro을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Face Swap Pro을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.