上傳影片的 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,請回報失敗訊息以及任何傳回的已計費點數。若要重新嘗試,則需要新的核准。