爆款复刻
爆款复刻把一条已验证的爆款视频变成可批量复用的创作模板:提供一条爆款参考视频和商品图,系统学习参考视频的风格、节奏与镜头结构,再结合你的商品,生成风格、节奏一致的全新营销视频。
适用场景:电商带货短视频、跨境营销素材、达人风格批量复刻。
类型
通过 Mode 参数区分三种类型:
| 类型 | Mode 取值 | 说明 |
|---|---|---|
| 脚本级复刻 | script(默认) | 学习参考视频的脚本结构与风格,结合商品信息生成新视频;可指定时长、画幅、口播语言和目标市场 |
| 动作级复刻 | motion | 逐段跟随参考视频的动作与景别,把人物、商品、服饰或背景替换成你提供的参考图;成片时长与画幅跟随参考视频 |
| 深度视频估计 | depth | 独立能力,只输出参考视频对应的黑白深度视频 |
模型档位
通过 AIGCParam.ModelTier 选择模型档位。深度视频估计无需选择档位。
| 档位 | ModelTier 取值 | 脚本级复刻 | 动作级复刻 | 单次生成时长上限 | 参考图数量上限 |
|---|---|---|---|---|---|
| 专业版 | pro | 支持 | 支持 | 30 秒 | 9 张 |
| 高级版 | flash(默认) | 支持 | 支持 | 15 秒 | 9 张 |
接口文档
| 用途 | 接口 | 官方文档 | API Explorer |
|---|---|---|---|
| 发起爆款复刻 | CloneViral | CloneViral | 在线调试 |
| 查询任务结果 | DescribeCloneViralTask | DescribeCloneViralTask | 在线调试 |
基本信息
| 项目 | 值 |
|---|---|
| 请求域名 | 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 | 否 | String | COS 桶所在地域,Type=cos 时使用 |
Output.CosInfo.Bucket | 否 | String | COS 桶名,Type=cos 时使用 |
Output.CosInfo.Dir | 否 | String | 输出目录,为空时默认根目录 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
TaskId | String | 任务创建成功后返回的任务 ID,用于查询接口轮询进度与结果 |
Status | String | 任务状态,失败时返回 FAIL |
Message | String | 失败时返回的错误信息 |
RequestId | String | 唯一请求 ID,定位问题时需提供 |
请求示例
以下示例中的 URL、商品名与卖点都是示例值,请替换为你自己的素材;参考视频与参考图需为服务端可公网访问的地址。
示例 1:脚本级复刻
{
"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"
}
}响应:
{
"Response": {
"TaskId": "1300057393-ViralCloneAsync-bfea1147-48d4-418f-87b0-71ba350c38bc",
"RequestId": "bfea1147-48d4-418f-87b0-71ba350c38bc"
}
}示例 2:动作级复刻 —— 换人物 + 指定服装
用 Persona.Images 指定人物,用 UserPrompt 描述服装:
{
"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:
{
"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 并传入参考视频即可,无需商品图,也无需选择档位:
{
"Mode": "depth",
"VideoUrl": "https://your-bucket-1250000000.cos.ap-singapore.myqcloud.com/viral/reference.mp4",
"AIGCParam": {
"DepthWithAudio": true
}
}查询结果(DescribeCloneViralTask)
请求参数
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
TaskId | 否 | String | CloneViral 返回的任务 ID(文档标为非必填,实际查询时都应传入) |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
Status | String | WAIT:等待中;RUN:执行中;FAIL:任务失败;DONE:任务成功 |
Message | String | 失败时返回的错误信息 |
VideoUrls | Array of String | Status 为 DONE 时返回的视频 URL 列表,保存 24 小时 |
RequestBody | String | 发起任务时的请求体,便于回查参数 |
RequestId | String | 唯一请求 ID |
示例
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"
}响应:
{
"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,所有字段原样送达。
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 Reference | MPS 鉴权、TC3 签名与请求执行的通用规范 |
| SDK Reference | 用官方 SDK 调用 MPS 关键接口的完整流程 |
| Media AI Agent 快速入门 | 同目录下 VOD 侧的视频剪辑智能体 |