요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
face_enhance | 아니요 | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. 기본값: false |
face_mapping | 아니요 | Multi-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order. |
image_url | 예 | 출발점이 되는 이미지. |
reference_image_url | 예 | Reference face image. The facial features from this image are transferred onto the target. |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
style | 아니요 | 미리 준비된 스타일이나 장르. realistic · beautify · lossless · 기본값: realistic |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 1.95 | US$0.02 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 2크레딧/장(US$0.02)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Face Swap API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/face-swap-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-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"style": "realistic"
}
}'
# 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 API 질문
Face Swap API 요금은 얼마인가요?
Face Swap 가격은 2크레딧(US$0.02) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Face Swap의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 얼굴 바꾸기: popnow/face-swap-v1/edit을(를) 넣으세요.
Face Swap과 Head Swap은 뭐가 다른가요?
Face Swap은 이목구비만 옮기고 대상의 헤어스타일과 두상을 유지합니다. Head Swap은 헤어와 실루엣을 포함해 머리 전체를 교체합니다. 머리가 바뀌어야 하는지로 고르시면 됩니다.
image_url에는 어떤 이미지를 넣나요?
바뀌는 쪽입니다. reference_image_url이 얼굴을 줍니다. 둘은 서로 바꿔 쓸 수 없고, 바꿔 넣어도 요청은 유효하지만 완전히 다른 결과가 나옵니다. 잡아 줄 오류도 없습니다.
프롬프트나 마스크가 있나요?
없습니다. 스키마는 image_url, reference_image_url, seed입니다. 표현할 것도 칠할 영역도 없는데, 그 덕분에 모호한 지시문에서 오는 실패 유형이 통째로 사라집니다.
어떤 입력 사진이 가장 잘 맞나요?
얼굴이 뚜렷하게 보이고, 어느 정도 정면이며, 빛이 잘 들고, 화면에서 충분히 큰 사진입니다. 두 이미지의 빛 방향도 비슷하면 좋습니다. 측면, 모션 블러, 많이 가려진 얼굴, 아주 작은 얼굴에서 품질이 떨어집니다.
사진에 얼굴이 여럿이어도 되나요?
아니요. 이미지당 얼굴 하나가 전제이고, 단체 사진에서는 어느 사람을 뜻하는지 알릴 방법이 없습니다. 보내기 전에 대상만 남기고 크롭하세요.
코드 없이 Face Swap을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Face Swap을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.