요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 출발점이 되는 이미지. |
output_format | 아니요 | 결과 파일 형식. png · jpeg · webp · 기본값: jpeg |
output_quality | 아니요 | Requested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · 기본값: 95 |
prompt | 아니요 | Optional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle. |
reference_image_url | 예 | Reference face image. The facial identity from this image is transferred onto the target. |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 24 | US$0.24 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Face Swap Plus API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/face-swap-v1-plus/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-plus/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"output_format": "jpeg"
}
}'
# 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 Plus API 질문
Face Swap Plus API 요금은 얼마인가요?
Face Swap Plus 가격은 24크레딧(US$0.24) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Face Swap Plus의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 얼굴 바꾸기: popnow/face-swap-v1-plus/edit을(를) 넣으세요.
image_url에는 어느 이미지를 넣습니까?
바뀌는 쪽입니다. 얼굴을 주는 쪽은 reference_image_url입니다. 두 항목은 서로 바꿔 넣을 수 없습니다. 뒤바꿔도 요청 자체는 유효하고 결과만 완전히 달라지므로 이 실수를 잡아 주는 오류는 나오지 않습니다.
`prompt` 필드가 있는데 효과가 있습니까?
저희 실측에서는 확인되지 않았습니다. 2026-09-20에 이 엔드포인트로 실제 호출을 다섯 번 보냈고 선글라스 두 번, 다른 머리 모양 한 번, 바뀐 표정 두 번을 지시했지만, 모두 같은 요청에서 필드를 비웠을 때와 구분되지 않았습니다. 모델은 값을 받아들이고 오류도 경고도 반환하지 않으므로, 이 필드에 의존한 호출은 성공한 것처럼 보입니다. 작동하지 않는 것으로 보고 보내지 마시기 바랍니다.
seed를 고정하면 같은 결과가 보장됩니까?
보장되지 않습니다. 같은 짝의 두 실행에 같은 추첨을 줄 뿐이며, 한 가지만 바꿔 비교할 때 공정해집니다. 비교를 위한 도구이지 바이트까지 같은 이미지를 약속하는 장치가 아닙니다.
두 이미지는 어떤 사진이어야 합니까?
각각 얼굴 하나가 또렷하게 보이고, 심한 측면이 아니며, 초점이 맞고, 이목구비가 읽힐 만큼 크게 담겨야 하며 형식은 JPEG, PNG, WebP 중 하나입니다. 단체 사진은 보내기 전에 한 사람으로 잘라 내십시오. 피부 톤은 맞춰 주지만 빛의 방향은 맞춰 주지 않으므로, 타깃과 대략 같은 쪽에서 빛을 받은 레퍼런스가 여전히 가장 깔끔한 턱선을 냅니다.
Face Swap Plus API의 제한은 무엇인가요?
프롬프트 길이(글자): 200. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Face Swap Plus을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Face Swap Plus을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.