업로드된 비디오를 위한 라이브 페이스 스왑
연결된 Live Face Swap MCP 도구를 사용합니다. 도구를 사용할 수 없는 경우 사용자를 설치 안내 또는 Live Face Swap MCP 가이드로 안내합니다. 사용자가 선택한 연결을 사용합니다. 로컬 테스트의 경우 모든 호출을 로컬 연결로 유지합니다.
견적 및 준비
- 가격 견적을 위해
durationSeconds를 1에서 30 사이로 설정하여quote_video_face_swap을 호출합니다. 지속 시간을 모르는 경우 사용자에게 물어보세요.estimatedCredits를 견적으로 보고합니다. 견적 전용 요청은 여기서 종료됩니다. - 사용자가 작업을 준비하려면 인수 없이
prepare_video_face_swap을 호출합니다. 반환된draftId를 저장하고preparationUrl을 비공개로 공유합니다. 링크는 30분 후에 만료됩니다. 사용자에게 동일한 Live Face Swap 계정으로 링크를 열고, 1~30초 길이의 MP4 파일(얼굴이 명확히 보이는 것)과 사용 권한이 있는 초상화를 선택하고, 사이트에 표시된 정확한 견적을 승인하도록 요청합니다. 소스 파일은 해당 브라우저 워크플로우에 유지합니다.
승인된 작업 시작
- 사용자가 사이트에서 정확한 견적을 승인했음을 확인하고 명시적으로 시작을 요청하면 동일한
draftId로create_video_face_swap을 호출합니다. 시작하면 크레딧이 예약됩니다. 상태 확인을 위해 반환된taskId를 저장합니다. - 서버가
VIDEO_MCP_APPROVAL_REQUIRED를 보고하면 사용자를 준비 링크로 다시 보냅니다. 드래프트가 만료되었거나 견적이 변경된 경우 새 준비 링크를 제공하고 승인 단계를 반복합니다. 시작 요청이 시간 초과되거나 결과가 불명확한 경우 동일한draftId로 재시도하여 중복 작업을 방지합니다.
확인 및 다운로드
- 기존
taskId로get_video_face_swap_result를 호출합니다. 상태 전용 요청의 경우 현재 상태를 보고합니다. 완료를 기다리는 동안retryAfterSeconds를 존중하여 다시 확인하기 전에 대기합니다. 호출이 속도 제한에 걸리면 서버의 재시도 지연 시간을 사용합니다. completed상태에서billedCredits가 반환되면 이를 보고하고 비공개resultUrl을 사용자와 공유합니다. 결과 페이지는 브라우저에서 비디오를 마무리하고 MP4 미리보기 및 다운로드를 제공합니다.failed상태에서는 실패와 반환된 청구된 크레딧을 보고합니다. 새로운 시도는 새로운 승인이 필요합니다.