요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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. |
reference_image_url | 예 | Reference face image. The facial features from this image are carried onto the person in the video. |
style | 아니요 | 미리 준비된 스타일이나 장르. realistic · beautify · lossless · 기본값: realistic |
video_url | 예 | 작업할 영상. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| 기본 | 3.9 | US$0.039 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Video Face Swap API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/face-swap-video-v1/video-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-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"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 탭에 있어요.
Video Face Swap API 질문
Video Face Swap API 요금은 얼마인가요?
Video Face Swap 가격은 3.9크레딧(US$0.039) /초입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Video Face Swap의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 영상 얼굴 바꾸기: popnow/face-swap-video-v1/video-edit을(를) 넣으세요.
Face Swap과 무엇이 다릅니까?
Face Swap은 정지 이미지를 바꿉니다. Video Face Swap은 같은 종류의 이목구비 전환을 클립 전체에 걸쳐 프레임마다 수행합니다. 참고 얼굴은 두 경우 모두 정지 이미지입니다.
어느 입력에 무엇을 넣습니까?
video_url에는 바꿀 영상을, reference_image_url에는 얼굴을 제공할 사진을 넣습니다. 하나는 영상이고 하나는 정지 이미지라서 실수로 뒤바뀔 일이 없습니다.
prompt, 마스크, seed가 있습니까?
없습니다. 스키마는 video_url, reference_image_url, 그리고 선택형 style뿐입니다. 문구를 다듬을 필요도, 영역을 칠할 필요도 없어서 모호한 지시로 인한 실패가 통째로 사라집니다.
style은 무엇을 골라야 합니까?
기본값인 realistic으로 시작하십시오. 자연스러운 피부 톤과 질감을 유지합니다. beautify는 피부를 매끄럽고 밝게 보정합니다. lossless는 참고 얼굴의 디테일을 최대한 살려 클로즈업에 잘 맞습니다.
어떤 영상이 가장 잘 됩니까?
화면에 한 사람만 나오고, 얼굴이 충분히 크며, 조명이 고르고, 카메라에서 오래 고개를 돌리지 않는 영상입니다. 심한 옆모습, 빠른 움직임으로 인한 흔들림, 얼굴을 가리는 손, 너무 작은 얼굴에서는 품질이 떨어집니다.
코드 없이 Video Face Swap을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Video Face Swap을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
