Communitygithub.com

lfs-video-face-swap

估算积分、准备并启动已批准的上传MP4视频换脸,或使用Live Face Swap MCP检查并下载现有的视频换脸任务。

lfs-video-face-swap 是什么?

该技能允许用户通过Live Face Swap MCP对上传的MP4视频进行换脸处理。它提供完整的任务生命周期管理:通过`quote_video_face_swap`估算所需积分,通过`prepare_video_face_swap`创建一个有效期为30分钟的草稿链接供用户上传视频并批准报价,再通过`create_video_face_swap`启动已批准的换脸任务。用户可调用`get_video_face_swap_result`检查任务状态或下载处理完成的视频,结果页面提供MP4预览和下载。支持本地测试连接,并在发生错误(如过期、费率限制或明确失败)时给出清晰的恢复指引。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aloow/lfs-video-face-swap/tree/main

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

已上传视频的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 时,报告失败信息及任何返回的已计积分。新的尝试需要重新进行审批。

相关技能