已上传视频的Live Face Swap换脸处理
使用已连接的Live Face Swap MCP工具。如果这些工具不可用,请引导用户查阅安装说明或Live Face Swap MCP指南。使用用户选择的连接。对于本地测试,请将所有调用保持在本地连接上。
估算与准备
- 如需价格估算,请使用
durationSeconds参数调用quote_video_face_swap,参数值介于1到30之间。如果不知道时长,请询问用户。将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时,报告失败信息及任何返回的已计积分。新的尝试需要重新进行审批。