Communitygithub.com

lfs-video-face-swap

크레딧을 예측하고, 승인된 얼굴 바꾸기를 준비 및 시작하거나, 업로드된 MP4에 대한 기존 비디오 얼굴 바꾸기 작업을 확인하고 다운로드합니다. 사용자가 라이브 페이스 스왑으로 사전 녹화된 비디오를 처리하거나 라이브 페이스 스왑 작업에 대해 문의할 때 사용합니다.

lfs-video-face-swap란 무엇인가요?

이 스킬은 사용자가 업로드한 MP4 비디오에 대해 Live Face Swap MCP 도구를 사용하여 얼굴 바꾸기 작업을 관리합니다. 주요 기능으로는 크레딧 예상 견적 요청, 작업 준비 (draftId 생성 및 준비 URL 제공), 승인된 작업 시작, 작업 상태 확인 및 완료된 비디오 다운로드 등이 있습니다. 사용자는 1~30초 길이의 MP4 파일과 사용 권한이 있는 초상화를 제공해야 하며, 작업 시작 전에 웹사이트에서 견적을 승인해야 합니다. 이 스킬은 Live Face Swap MCP 연결이 필요하며, 로컬 테스트 시 모든 호출을 로컬 연결로 유지합니다. 크레딧이 부족하거나 드래프트가 만료된 경우 사용자에게 새 준비 링크를 제공하여 재승인 과정을 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aloow/lfs-video-face-swap/tree/main

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

업로드된 비디오를 위한 라이브 페이스 스왑

연결된 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 상태에서는 실패와 반환된 청구된 크레딧을 보고합니다. 새로운 시도는 새로운 승인이 필요합니다.

관련 스킬