Agent Skills
返回列表
腾讯云视频人脸融合

腾讯云视频人脸融合

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/tencentcloud-video-face-fusion。

技能介绍

要解决什么问题

当你有一段带固定人脸角色的短视频模板(例如广告、拜年、活动片头),希望把成片里某张脸换成指定用户的人脸,而不是在本地用 FFmpeg 或通用图像模型「猜」一帧帧贴图时,就需要调用云端的视频人脸融合服务:输入模板视频 URL、模板中要替换的人脸参考图,以及用户人脸图,由后端做跟踪与融合,输出新 MP4。

技能如何工作

本技能封装腾讯云 SubmitVideoFaceFusionJob 与 DescribeVideoFaceFusionJob,默认走 scripts/main.py:提交任务 → 按间隔轮询 → 返回完成后的结果(可用 --no-poll 只拿 JobId)。若你要自己管队列,可拆成 submit_job.py 与 query_job.py。

典型参数关系:

  • --video-url:模板视频(mp4,≤1G,≤20s,分辨率≤4K,fps≤25)
  • --template / --face:模板侧人脸与用户侧人脸,可多次指定且一一对应
  • --logo-add:是否在成片加 AI 合成标识(默认开启)

Agent 侧规范强调:用户已给出视频 URL 与人脸图且意图明确时,应直接执行脚本;服务失败时不得用大模型编造「融合结果」。

适用边界与注意

  • 依赖 腾讯云 API 密钥与已开通的视频创作相关能力;密钥仅通过环境变量配置,勿写进代码。
  • 全流程为异步任务,长视频或排队时需合理设置 --poll-interval 与 --max-poll-time。
  • 详细错误码与字段说明见技能内 references/ 文档;Python 3.7+ 与 tencentcloud-sdk-python 由脚本按需处理依赖。

使用场景

  • 市场部持有≤20 秒的 MP4 品牌模板,需把片中固定人脸换成指定 KOL 或用户肖像并拿到可下载成片。
  • 活动运营用同一套拜年/庆典视频模板,对每位参与者的人脸图批量提交融合任务并收集结果链接。
  • 对话式 Agent 场景中用户已给出 `--video-url` 与 `--face`/`--template`,需默认跑 main.py 轮询至任务完成。
  • 自建系统已用 submit_job 拿到 JobId,需在队列或定时任务里用 query_job 查询状态并取回融合视频 URL。

适合人员

  • 负责品牌短视频投放、拿到腾讯云模板素材后要把模板人脸换成指定人物头像的市场或增长运营。
  • 编写对话 Agent,要求在用户给出视频与人脸 URL 后必须执行 Submit/Describe 脚本、禁止伪造成片的集成工程师。
  • 对接腾讯云视频创作接口、需要把「仅提交」与「仅查询」拆进自有任务队列的后端或平台开发。
  • 用统一片头/口播模板为多位达人或客户生成「同模板不同脸」定制短视频的内容制片或 MCN 协作同学。