소개
Video Face Swap은 참고 이미지 한 장의 이목구비를 영상 속 인물에게 클립의 모든 프레임에 걸쳐 옮깁니다. 옮겨지는 것은 얼굴의 특징뿐입니다. 출연자의 헤어스타일, 머리 윤곽, 움직임, 의상, 조명, 카메라 워크, 배경은 촬영한 그대로 남기 때문에 결과물은 위에 덧씌운 화면이 아니라 원래 영상처럼 보입니다.
Video Face Swap은 영상 클립과 참고 얼굴 이미지를 받아 이목구비만 영상 속 인물에게 옮기고, 머리카락, 움직임, 구도, 배경은 그대로 유지합니다. URL 두 개와 선택형 질감 설정뿐이며, 작성할 prompt 입력란은 없습니다.
핵심 기능 및 하이라이트
연기는 유지하고 얼굴 정체성만 바꾸기
Face Swap은 승인된 참조 이미지의 정체성을 제공된 영상 속 인물에게 적용하면서 실사 연기를 유지합니다. 피사체, 프레이밍, 조명이 이미 잘 잡힌 클립을 고르세요. 이 워크플로는 정체성을 교체하는 것이지 장면을 새로 만드는 작업이 아닙니다.
합성 장면이 아니라 연속성 검토하기
회전, 컷, 빠른 움직임까지 일반 재생 속도로 결과를 검토하세요. 정체성 교체가 자연스러운지, 머리카락·움직임·의상·배경이 원본 영상으로 계속 읽히는지 확인합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 바꿀 영상입니다. 이 인물의 머리카락, 머리 형태, 움직임, 의상과 장면 전체는 그대로 두고 이목구비만 교체합니다.동영상 파일 자체를 가리키는 직접 링크여야 합니다. 1자 이상 |
reference_image_url | 예 | 이목구비를 제공하는 정지 이미지입니다. 얼굴만 가져오고 머리카락이나 머리 형태는 가져오지 않습니다. 1자 이상 |
face_mapping | 아니요 | 여러 사람이 나오는 영상용입니다. 레퍼런스의 어느 얼굴을 영상의 어느 얼굴에 넣을지 항목마다 한 쌍씩 적으며, 얼굴 번호는 검출 순서대로 0부터 셉니다. 10개 이하 |
face_enhance | 아니요 | 바꾼 얼굴에 얼굴 보정 단계를 한 번 더 적용해 더 높은 해상도로 만듭니다. 기본값은 꺼짐입니다. 기본값: |
style | 아니요 | realistic(기본값)은 자연스러운 피부 톤과 질감을 유지하고, beautify는 피부를 매끄럽고 밝게 보정하며, lossless는 참고 얼굴의 디테일을 최대한 살립니다. 먼저 realistic으로 시험해 보십시오. |
요금
$0.026 / 출력 초
원본 클립을 10초 단위로 올림하여 과금합니다. 12초 클립은 20초분입니다. 원본 클립은 3~40초 길이여야 합니다. 제출 전 견적은 업로드한 클립이면 실제 길이로, 동영상 URL이면 최대 40초로 계산하며, 차액이 있으면 정산 시 해제됩니다.
활용 사례
제공한 클립을 수정합니다
Video Face Swap은 참고 이미지 한 장의 이목구비를 영상 속 인물에게 클립의 모든 프레임에 걸쳐 옮깁니다. 옮겨지는 것은 얼굴의 특징뿐입니다. 출연자의 헤어스타일, 머리 윤곽, 움직임, 의상, 조명, 카메라 워크, 배경은 촬영한 그대로 남기 때문에 결과물은 위에 덧씌운 화면이 아니라 원래 영상처럼 보입니다. 원본 영상이 편집의 출발점이어야 할 때 사용합니다. 변경 사항을 정확히 설명하고 연속성, 타이밍, 보존할 세부 사항을 검토합니다.
생성한 시리즈를 같은 얼굴로 통일
어떤 영상 모델로든 클립 여러 개를 생성한 뒤, 동의받은 얼굴 하나를 모두에 옮기면 시리즈 전체가 같은 인물로 보입니다. 움직임, 의상, 세트는 각 클립에 남아 있으므로 생성으로 얻은 변화도 그대로 살아납니다.
동의한 출연자의 초상으로 만드는 무검열 콘텐츠
사용 권한이 있는 얼굴을 직접 제작한 영상에 옮깁니다. 무검열 소재라고 요청이 달라지는 것은 없습니다. 다만 아래 사용 범위에 있는 권한 요건은 형식이 아니라 반드시 지켜야 하는 조건입니다.
이미 완성된 테이크의 출연자 교체
조명, 동선, 카메라 움직임이 이미 승인된 테이크는 그대로 두고 얼굴만 바꿉니다. 샷 전체를 다시 생성하느라 좋은 연기를 잃을 필요가 없습니다.
프롬프트 가이드 및 실전 팁
두 얼굴에 대한 권리부터 확인합니다
기술 작업에 앞서, 영상과 참고 이미지에 모두 사람이 나오므로 옮길 초상과 그 초상을 넣을 영상 양쪽에 대한 권한이 필요합니다. 동의서는 작업 기록과 함께 보관하십시오.
영상과 얼굴을 올리고 한 쌍으로 보냅니다
video_url은 바꿀 영상이고 reference_image_url은 얼굴을 제공하는 정지 이미지입니다. 기본 realistic 질감이 맞지 않을 때만 style을 추가하십시오. 작성할 prompt는 없습니다.
Check the result before iterating
참고 이미지에는 선명하게 보이고 거의 정면이며 조명이 좋은 얼굴이 있어야 하고, 영상은 한 사람의 얼굴이 계속 충분히 크게 보일 때 가장 잘 됩니다. 심한 옆모습, 빠른 움직임으로 인한 흔들림, 얼굴 앞을 지나가는 손이나 물체, 아주 작은 얼굴에서는 전환 품질이 떨어지거나 실패합니다. 참고 이미지와 영상의 조명 방향이나 피부 톤이 크게 다르면 턱선에서 드러납니다. 처리하는 얼굴은 하나뿐이어서 여러 사람이 나올 때 누구를 뜻하는지 알릴 방법이 없습니다. prompt, 마스크, seed가 없으므로 결과가 맞지 않으면 요청 문구를 고칠 것이 아니라 참고 이미지나 영상 편집을 바꿔야 합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/face-swap-video-v1/video-edit",
"input": {
"reference_image_url": "https://example.com/reference.png",
"style": "realistic",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
