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