跳到内容

爆款复刻 ​

更新时间

爆款复刻把一条已验证的爆款视频变成可批量复用的创作模板:提供一条爆款参考视频和商品图,系统学习参考视频的风格、节奏与镜头结构,再结合你的商品,生成风格、节奏一致的全新营销视频。

适用场景:电商带货短视频、跨境营销素材、达人风格批量复刻。

类型 ​

通过 Mode 参数区分三种类型:

类型Mode 取值说明
脚本级复刻script(默认)学习参考视频的脚本结构与风格,结合商品信息生成新视频;可指定时长、画幅、口播语言和目标市场
动作级复刻motion逐段跟随参考视频的动作与景别,把人物、商品、服饰或背景替换成你提供的参考图;成片时长与画幅跟随参考视频
深度视频估计depth独立能力,只输出参考视频对应的黑白深度视频

模型档位 ​

通过 AIGCParam.ModelTier 选择模型档位。深度视频估计无需选择档位。

档位ModelTier 取值脚本级复刻动作级复刻单次生成时长上限参考图数量上限
专业版pro支持支持30 秒9 张
高级版flash(默认)支持支持15 秒9 张

接口文档 ​

用途接口官方文档API Explorer
发起爆款复刻CloneViralCloneViral在线调试
查询任务结果DescribeCloneViralTaskDescribeCloneViralTask在线调试

基本信息 ​

项目值
请求域名mps.intl.tencentcloudapi.com
接口版本Version: 2019-06-12
Region公共参数,本接口不需要传
调用方式异步:CloneViral 返回 TaskId,再用 DescribeCloneViralTask 轮询
频率限制两个接口均为 20 次/秒
结果有效期默认返回临时链接,保存 24 小时;也可通过 Output 写入自有 COS
鉴权腾讯云 API 3.0 公共参数(TC3-HMAC-SHA256 签名),见 API Reference

前提条件 ​

使用前需完成:注册 / 登录腾讯云国际站账号、开通 MPS、完成服务角色授权。若使用子账号,还需确保该子账号有调用 MPS 的权限。

计费说明 ​

  • 脚本级复刻、动作级复刻:收取「爆款复刻」费用,按模型档位分别计费。
  • 深度视频估计:收取「深度视频估计」费用。

具体单价以腾讯云官网 MPS 计费说明为准。

发起任务(CloneViral) ​

基础参数 ​

参数必选类型说明
Mode否String复刻类型:script(脚本级复刻,默认)/ motion(动作级复刻)/ depth(深度视频估计)
VideoUrl是String爆款参考视频的 URL
Product视类型Object商品信息,见下文
Persona否Object模特形象,见下文
Reference否Object补充参考素材(服饰、背景),见下文
AIGCParam否Object生成参数,见下文
ContentParam否Object内容与风格参数,见下文
Output否Object输出位置,见下文

商品参数(Product) ​

脚本级复刻必填,至少传入 1 张商品图;动作级复刻可选,非带货类视频可不传;深度视频估计不需要。

参数必选类型说明
Product.Images视类型Array of String商品图 URL。脚本级复刻必填、至少 1 张;动作级复刻选填,作为商品参考图使用
Product.Name否String商品名称
Product.Description否String商品卖点描述

模特形象参数(Persona) ​

传入 Persona 对象即启用模特形象设置。

参数必选类型说明
Persona.Images否Array of String人物形象参考图 URL,用于指定成片中的人物外观
Persona.Gender否String性别:male(男性)/ female(女性)/ any(不限)
Persona.Age否String年龄段:teenager(青少年)/ youth(青年)/ middle_aged(中年)/ senior(老年)
Persona.Ethnicity否String外观特征:caucasian(欧美白人)/ asian(亚裔)/ latino(拉丁)/ african(非裔)/ middle_eastern(中东)
Persona.BodyType否String体型:slim(纤细)/ standard(标准)/ athletic(健美)/ chubby(微胖)

补充参考素材(Reference) ​

仅动作级复刻支持

Reference 目前只有 Mode=motion 支持,其他类型传入会返回参数错误。人物图请用 Persona.Images,商品图请用 Product.Images。

参数必选类型说明
Reference.Outfits否Array of String服饰套装参考图 URL。传入多套时,按参考视频的镜头切换依次换装
Reference.Backgrounds否Array of String背景 / 场景参考图 URL

生成参数(AIGCParam) ​

参数必选类型说明
AIGCParam.ModelTier否String模型档位:pro(专业版)/ flash(高级版,默认),见「模型档位」
AIGCParam.Duration否Integer视频时长(秒),仅脚本级复刻生效。不填或填 0 时跟随参考视频;指定时取值随档位不同:flash 为 2–15,pro 为 4–30
AIGCParam.AspectRatio否String宽高比。不填时根据参考视频自动选择 9:16(竖屏)或 16:9(横屏)。可选 9:16 / 16:9 / 3:4 / 4:3 / 1:1 / 21:9 / adaptive(自适应参考视频,flash 档不支持)
AIGCParam.Resolution否String分辨率:720p(默认)/ 1080p。深度视频估计下不生效,分辨率跟随参考视频
AIGCParam.DepthWithAudio否Boolean深度视频是否保留参考视频的音轨,默认 false(不带音频)

内容与风格参数(ContentParam) ​

参数必选类型说明
ContentParam.UserPrompt否String自定义提示词,对生成视频的额外要求
ContentParam.Language否String口播语言,仅脚本级复刻生效:zh(中文)/ en(英语)/ ja(日语)/ ko(韩语)/ es(西班牙语)/ pt(葡萄牙语)/ de(德语)/ fr(法语)/ it(意大利语)/ pl(波兰语)/ instrumental(纯音乐,无口播)
ContentParam.Market否String目标市场,影响本地化风格,仅脚本级复刻生效:north_america(北美)/ europe(欧洲)/ china(中国)/ japan(日本)/ korea(韩国)/ sea(东南亚)/ brazil(巴西)

输出参数(Output) ​

不传时结果以临时链接返回(保存 24 小时)。

参数必选类型说明
Output.Type否String输出类型:url(默认,临时链接,有效期 24 小时)/ cos(写入指定 COS 桶和路径)
Output.CosInfo.Region否StringCOS 桶所在地域,Type=cos 时使用
Output.CosInfo.Bucket否StringCOS 桶名,Type=cos 时使用
Output.CosInfo.Dir否String输出目录,为空时默认根目录

返回参数 ​

参数类型说明
TaskIdString任务创建成功后返回的任务 ID,用于查询接口轮询进度与结果
StatusString任务状态,失败时返回 FAIL
MessageString失败时返回的错误信息
RequestIdString唯一请求 ID,定位问题时需提供

请求示例 ​

以下示例中的 URL、商品名与卖点都是示例值,请替换为你自己的素材;参考视频与参考图需为服务端可公网访问的地址。

示例 1:脚本级复刻 ​

json
{
  "Mode": "script",
  "VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/reference.mp4",
  "Product": {
    "Images": [
      "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/pic1.png",
      "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/pic2.png",
      "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/pic3.png"
    ],
    "Name": "冰丝白裙",
    "Description": "凉感冰丝面料,速干透气,多色可选"
  },
  "AIGCParam": {
    "ModelTier": "flash",
    "Duration": 10,
    "AspectRatio": "9:16",
    "Resolution": "720p"
  },
  "ContentParam": {
    "UserPrompt": "在阳光明媚的公园场景中展示产品",
    "Language": "zh",
    "Market": "china"
  },
  "Persona": {
    "Gender": "female",
    "Age": "youth",
    "Ethnicity": "asian",
    "BodyType": "standard"
  }
}

响应:

json
{
  "Response": {
    "TaskId": "1300057393-ViralCloneAsync-bfea1147-48d4-418f-87b0-71ba350c38bc",
    "RequestId": "bfea1147-48d4-418f-87b0-71ba350c38bc"
  }
}

示例 2:动作级复刻 —— 换人物 + 指定服装 ​

用 Persona.Images 指定人物,用 UserPrompt 描述服装:

json
{
  "Mode": "motion",
  "VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/motion/original.mp4",
  "AIGCParam": { "ModelTier": "pro" },
  "ContentParam": {
    "UserPrompt": "服装改成黑色皮夹克配黑色圆领内搭"
  },
  "Persona": {
    "Images": ["https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/motion/persona.jpg"]
  }
}

示例 3:动作级复刻 —— 换人物 + 商品 + 背景 ​

同时替换人物、商品与背景,背景图走 Reference.Backgrounds:

json
{
  "Mode": "motion",
  "VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/dance/original.mov",
  "AIGCParam": { "ModelTier": "pro" },
  "Persona": {
    "Images": ["https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/dance/persona.png"]
  },
  "Product": {
    "Images": ["https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/dance/product.jpg"]
  },
  "Reference": {
    "Backgrounds": ["https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/dance/background.png"]
  }
}

示例 4:深度视频估计 ​

深度视频估计是可独立使用的能力:只需一条参考视频,系统提取画面结构信息,输出对应的黑白深度视频。它同时也是动作级复刻的第一步 —— 动作级复刻在深度视频的基础上继续生成新视频,深度视频估计则在输出深度视频后结束。

将 Mode 设为 depth 并传入参考视频即可,无需商品图,也无需选择档位:

json
{
  "Mode": "depth",
  "VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/reference.mp4",
  "AIGCParam": {
    "DepthWithAudio": true
  }
}

查询结果(DescribeCloneViralTask) ​

请求参数 ​

参数必选类型说明
TaskId否StringCloneViral 返回的任务 ID(文档标为非必填,实际查询时都应传入)

返回参数 ​

参数类型说明
StatusStringWAIT:等待中;RUN:执行中;FAIL:任务失败;DONE:任务成功
MessageString失败时返回的错误信息
VideoUrlsArray of StringStatus 为 DONE 时返回的视频 URL 列表,保存 24 小时
RequestBodyString发起任务时的请求体,便于回查参数
RequestIdString唯一请求 ID

示例 ​

http
POST / HTTP/1.1
Host: mps.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeCloneViralTask
<公共请求参数>

{
  "TaskId": "24000191-ViralClone-92e56dab-2a5b-4537-b49f-854563d4903f"
}

响应:

json
{
  "Response": {
    "Status": "DONE",
    "VideoUrls": [
      "https://laurie-tmp-1300828900.cos.ap-nanjing.myqcloud.com/viral_clone/20260720/24000191-ViralClone-92e56dab-2a5b-4537-b49f-854563d4903f/clip.mp4"
    ],
    "RequestId": "74aeda83-63cc-4404-9f10-e43e841d242c"
  }
}

结果链接是临时地址

VideoUrls 只保存 24 小时,拿到后请及时下载或转存到自己的存储;需要长期保存可在发起任务时用 Output 直接写入自有 COS。

Python 调用 ​

用 CommonClient 发原始 JSON,不要用 MpsClient.CloneViral

国际站 SDK tencentcloud-sdk-python-intl-en 的 CloneViral 请求模型还停留在旧版字段,没有 Mode、Reference、Output、Persona.Images、DepthWithAudio。用 from_json_string 填这些字段时,SDK 只打印一条 fileds are useless 警告,不会把它们发给服务端,任务会静默按默认的脚本级复刻执行。下面的写法用 CommonClient.call_json 直接发 JSON,所有字段原样送达。

python
import os, time
from tencentcloud.common import credential
from tencentcloud.common.common_client import CommonClient
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile

cred = credential.Credential(os.environ["TENCENT_SECRET_ID"], os.environ["TENCENT_SECRET_KEY"])
client_profile = ClientProfile(httpProfile=HttpProfile(endpoint="mps.intl.tencentcloudapi.com"))
client = CommonClient("mps", "2019-06-12", cred, "ap-singapore", profile=client_profile)

# ① 发起动作级复刻
resp = client.call_json("CloneViral", {
    "Mode": "motion",
    "VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/motion/original.mp4",
    "AIGCParam": {"ModelTier": "pro"},
    "Persona": {"Images": ["https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/motion/persona.jpg"]},
})["Response"]
if resp.get("Status") == "FAIL":
    raise RuntimeError(resp.get("Message"))
task_id = resp["TaskId"]

# ② 轮询结果
while True:
    r = client.call_json("DescribeCloneViralTask", {"TaskId": task_id})["Response"]
    if r["Status"] == "DONE":
        print("Video URLs:", r["VideoUrls"])
        break
    if r["Status"] == "FAIL":
        raise RuntimeError(f"task failed: {r.get('Message')}")
    time.sleep(5)

密钥、地域与 Endpoint 的配置方式与 SDK Reference 一致。

相关文档 ​

文档说明
API ReferenceMPS 鉴权、TC3 签名与请求执行的通用规范
SDK Reference用官方 SDK 调用 MPS 关键接口的完整流程
Media AI Agent 快速入门同目录下 VOD 侧的视频剪辑智能体

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages