Head Swap API: 가격, 파라미터, 코드

Name: Head Swap API
SKU: popnow/head-swap-v1/edit
Price: 0.02 USD
Availability: InStock

요청 파라미터

파라미터	필수	설명
`image_url`	예	출발점이 되는 이미지.
`reference_image_url`	예	Reference head image. The whole head, including hair and head shape, is transferred onto the target.
`seed`	아니요	같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션	크레딧 /장	≈ USD
기본	1.95	US$0.02

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 2크레딧/장(US$0.02)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Head Swap API를 3단계로 호출하기

API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
요청 보내기. POST /jobs/createTask에 model은 popnow/head-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/head-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"
  }
}'

# 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 탭에 있어요.

Head Swap API 질문

Head Swap API 요금은 얼마인가요?

Head Swap 가격은 2크레딧(US$0.02) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Head Swap의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 얼굴 바꾸기: popnow/head-swap-v1/edit을(를) 넣으세요.

Head Swap과 Face Swap은 뭐가 다른가요?

Head Swap은 얼굴과 헤어스타일, 머리색, 두상 실루엣까지 머리 전체를 교체합니다. Face Swap은 이목구비만 옮기고 대상의 헤어를 유지합니다. 머리가 바뀌어야 하는지로 고르시면 됩니다.

image_url에는 어떤 이미지를 넣나요?

바뀌는 쪽입니다. 유지하고 싶은 몸과 의상, 포즈, 배경이 담긴 이미지입니다. reference_image_url이 머리를 줍니다. 둘을 바꿔 넣어도 유효한 요청이지만 결과가 완전히 달라지고 오류도 안 납니다.

프롬프트나 마스크가 있나요?

없습니다. 스키마는 image_url, reference_image_url, seed입니다. 표현하는 게 없으니 결과는 고른 두 이미지에만 달려 있습니다.

목에 선이 왜 보이나요?

이 엔드포인트의 주된 실패 양상입니다. 대개 두 원본의 빛 방향이나 피부 톤이 다르거나, 대상의 목이 옷깃이나 스카프, 머리카락에 가려져 있다는 뜻입니다.

이미지에 무엇이 담겼는지에 따라 달라지나요?

달라지지 않습니다. 엔드포인트는 무엇이 담긴 대상이든 똑같이 다룹니다. 기준이 되는 건 동의입니다. 그 특정 초상을 그 특정 소재에 넣을 권한이 있어야 하고, 공개된 사진이라고 그 권한을 가정할 수는 없습니다.

코드 없이 Head Swap을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 Head Swap을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

Head Swap 더 알아보기

사용해 보기: Head Swap AI 얼굴 바꾸기 온라인 PopNow에서 Head Swap(으)로 이미지 만들기
문서: API 문서의 Head Swap 모델 ID와 입력 스키마 PopNow API 빠른 시작: 5분 만에 첫 요청 보내기 PopNow API 이미지 생성 가이드 Webhook: 폴링 없이 Head Swap 결과 받기