Communitygithub.com

lfs-video-face-swap

クレジットの見積もり、承認された顔交換の準備と開始、アップロードされたMP4の顔交換の確認とダウンロードをLive Face Swap MCPを使用して行います。ユーザーが録画済みビデオの処理をLive Face Swapに依頼した場合や、Live Face Swapタスクについて質問した場合に使用します。

lfs-video-face-swap とは?

このスキルは、Live Face Swap MCPツールを使用して、ユーザーがアップロードしたMP4ビデオに対して顔交換ジョブを管理するためのAIエージェント向け機能です。主な機能は、クレジットの見積もり(1〜30秒のビデオ長を指定)、ジョブの準備(draftIdと期限付きURLの発行)、承認後のジョブ開始(taskIdの保存とステータス確認)、および結果の確認とダウンロード(completed/failed状態の通知)です。MCPプロトコルをサポートするClaude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、ユーザーがブラウザ上で顔交換設定を承認するワークフローと連携します。このスキールは、API呼び出しのタイムアウトや重複ジョブの防止、レート制限への対応など、堅牢なエラーハンドリングを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aloow/lfs-video-face-swap/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アップロードされたビデオのLive Face Swap

接続された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状態の場合は、失敗内容と返された請求クレジットを報告します。新しい試行には新しい承認が必要です。

関連スキル