PopNowAPI 문서
본문

Face Swap Plus API 레퍼런스

피부 톤을 자동으로 맞추는 얼굴 바꾸기

PopNow API 키 하나로 내 코드에서 Face Swap Plus을(를) 호출할 수 있습니다. 보낼 모델 ID, 이 모델이 받는 모든 입력 필드, 요청 한 번에 드는 크레딧, 터미널에 붙여 넣으면 바로 실행되는 요청을 정리했습니다.

파라미터 설명은 모델의 입력 schema에서 가져오므로 영어로만 제공됩니다.

한눈에 보기

제작사
PopNow
결과물
이미지
최저가
24크레딧 이미지 1장당 ($0.24)
평균 소요 시간
약 31초
모델 ID

1크레딧 = 0.01달러. 작업이 접수되면 가능한 최대 금액을 먼저 잡아 두고, 끝나면 실제 사용량으로 정산합니다(정수 크레딧으로 올림, 남는 금액은 반환). 실패한 작업에는 과금하지 않습니다. 실행 전에 정확한 금액이 궁금하면 POST /api/v1/jobs/quote를 호출하세요.

얼굴 바꾸기

popnow/face-swap-v1-plus/edit

요금

옵션크레딧 (이미지 1장당)미국 달러
기본24$0.24

파라미터

필드타입기본값허용 값설명
image_url필수string——Target image. The face of the person in this image is the one that gets replaced.
reference_image_url필수string——Reference face image. The facial identity from this image is transferred onto the target.
prompt선택string—최대 200자Optional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
output_format선택stringjpegpng, jpeg, webpFile format of the returned image.
output_quality선택integer9510~100Requested image quality for the result, from 10 to 100.
seed선택integer—0~2147483647Random seed; reuse it to keep two runs over the same image pair comparable.

요청 예제

이 요청은 그대로 실행됩니다. 빠진 필드는 기본값을 씁니다. 먼저 키를 환경 변수 POPNOW_API_KEY에 넣어 두세요.

예제의 image_url, reference_image_url에는 PopNow 샘플 파일이 들어 있습니다. 직접 가진 공개 HTTPS 링크, 업로드한 파일, 저장한 에셋으로 바꿔 쓰세요.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "popnow/face-swap-v1-plus/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp"
  }
}'

응답에는 taskId가 바로 들어 있습니다. 결과는 GET /api/v1/jobs/recordInfo로 가져오거나, callBackUrl을 넣어 알림을 받으세요.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

다음 단계

이 페이지에서

한눈에 보기얼굴 바꾸기다음 단계