Avatar Face Swap API(베타): 영상에 아바타 얼굴 입히기

Avatar Face Swap 1.0은 준비된 아바타의 얼굴을 공개 소스 영상에 입히는 Sume API의 베타 model-run 엔드포인트입니다. avatar_handle, video_url, quality 등급을 담아 POST /v1/models/sume/avatar-face-swap/v1.0/runs를 보내세요. Sume는 Job 기반 페이스 스왑 리소스를 만들고, 완료된 리소스는 media.sume.com 아래의 공개 가능한 video_url을 노출합니다.

아래 내용은 모두 페이스 스왑 (Beta) 문서 페이지에서 가져왔습니다.

Avatar Face Swap은 아직 베타인가요?

네. 문서는 Avatar Face Swap 1.0을 베타 model-run 엔드포인트로 표시하고, 베타 단계의 규칙 두 가지를 명시합니다. quality는 생략 시 기본값이 없는 필수 필드이고, 워커 검증은 현재 사용할 만한 오디오가 있는 약 4-15초 길이의 소스 영상을 대상으로 계획되어 있습니다.

언제 아바타 영상 대신 Face Swap을 써야 하나요?

위의 Developer API 경로만 사용하세요. 예전 소비자 제품의 /face-swap 라우트가 아닙니다. 문서는 다음 경우에 Face Swap을 쓰라고 안내합니다.

• 이미 준비된 Avatar 1.0 아이덴티티가 있을 때. 만드는 방법은 재사용 가능한 AI 아바타 만들기에 나와 있습니다.
• 짧은 공개 소스 영상이 있고, 거기에 아바타 얼굴을 입히고 싶을 때.
• 스크립트 기반의 말하는 영상 생성이 필요하지 않을 때. 그런 생성에는 말하는 아바타 영상 API를 참고하세요.

페이스 스왑 Job은 어떻게 만드나요?

필수 필드 세 개를 보내세요. 베타에서는 quality가 필수이며, 이 엔드포인트에는 생략 시 기본값이 없습니다.

curl -X POST https://api.sume.com/v1/models/sume/avatar-face-swap/v1.0/runs \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "avatar_handle": "product_host",
    "video_url": "https://example.com/inputs/source-video.mp4",
    "quality": "plus"
  }'

Face Swap은 어떤 소스 영상을 받나요?

베타 워커 검증은 페이스 스왑 처리에 적합한 소스 영상을 대상으로 하며, 현재 사용할 만한 오디오가 있는 약 4-15초 길이로 계획되어 있습니다. video_url은 가져올 수 있는 공개 HTTPS 영상 URL이어야 합니다. 다음 URL은 거부됩니다.

• localhost URL
• 사설 네트워크 URL
• HTTPS가 아닌 URL
• 서명된 URL이나 비공개 URL
• 프로바이더 작업 URL

Face Swap은 무엇을 하지 않나요?

문서는 이 엔드포인트에서 의도적으로 지원하지 않는 항목을 다음과 같이 나열합니다.

• 프롬프트와 트랜스크립트
• 길이 조절 값과 화면 비율
• 본문 안의 아바타 id. 아바타는 avatar_handle로 지정하세요.
• 프로바이더 필드

결과는 어떻게 받나요?

Job 상태를 폴링한 다음 결과를 가져오세요. 완료된 리소스는 준비되면 media.sume.com 아래의 공개 가능한 video_url과 산출물을 노출합니다. 준비 여부에는 resource_status를, 폴링에는 job_status를 우선 사용하세요.

Face Swap은 OpenAPI에 문서화된 범위에서 다른 생성 제출과 같은 통신 모드를 받습니다.

curl https://api.sume.com/v1/jobs/job_123/status \
  -H "Authorization: Bearer $SUME_API_KEY"

curl https://api.sume.com/v1/jobs/job_123/result \
  -H "Authorization: Bearer $SUME_API_KEY"

Face Swap 비용은 얼마인가요?

Face Swap에는 준비된 아바타가 필요합니다. 아바타를 만드는 비용은 아바타당 $0.95이며, 여기에 기본 5.5% 에이전트 수수료가 더해집니다. 페이스 스왑 실행은 품질 등급별로 요금이 매겨지며, 현재 요율은 공개 카탈로그 GET /v1/catalog에 있습니다.