集锦任务

更新时间：2026-01-23

在智能集锦任一项目内，您可以选中若干个视频进行集锦创作。发起集锦任务后，系统将根据您的参数配置，进行相应的文案创作和视频剪辑。

关于请求头与响应头，请参考公共请求头与响应头。

1. 在深度分析项目中创建任务

深度分析项目中集锦任务分为两类：视频解说、视频精剪。

1.1 创建视频解说任务

请求结构

Http

1POST /v2/highlight/job/narration HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

请求参数

参数	类型	是否必填	描述
projectId	string	是	项目 ID
mediaList	object[]	是	用于创作的素材视频列表。
[+] mediaId	string	是	媒资 ID
[+] start	float		指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
presetIdOrName	string	是	玩法模板，填入模板名称或者模板 ID： `穿插解说模板 / fkkskynwqcjh1ned8f5j` 以线性叙事为原则的穿插解说 `含黄金片头的穿插解说模板 / fkpqe3m4basu644zjmkx` 以线性叙事为原则的穿插解说 `爆款解说模板 / fmcwq007crkxaiqmvbfx`智能生成一个自带流量的爆款解说视频，打造吸睛黄金开头，丝滑回溯故事起点，用“情绪过山车”循环持续吸引观众，最后采用“悬念钩子”勾起兴趣。 `漫剧解说模板 / fkksi4mv4j2iti9cr00z` 专为漫剧解说定制，自带吸睛片头与强节奏卡点。全程高密度解说，无缝衔接剧情。 `漫剧解说模板（第二人称）/ fm5x7un2z3najiudb410` 专为漫剧解说定制，采用第二人称，自带吸睛片头与强节奏卡点。全程高密度解说，无缝衔接剧情。 `漫剧解说模板（第三人称） / fm5xym21pyujfwv216zx` 专为漫剧解说定制，采用第三人称，自带吸睛片头与强节奏卡点。全程高密度解说，无缝衔接剧情。 `视频重构模板 / fksx93f3yx891drgknet`本模板旨在帮助您将原始的解说视频，提炼并重构为结构清晰、重点突出、语言流畅的新视频。
presetParams	map<string, string>		模板参数，参考附件的模板支持变量对照表 headDuration：黄金片头时长，默认12s，取值范围 [5, 15]
config	TaskConfig	是	创作配置参数

TaskConfig

参数	类型	是否必填	描述
narrationDub	NarrationDUB	是	解说配音配置
narrationSubtitle	NarrationSubtitle		解说字幕配置。不填则默认与原片字幕位置和大小一致
appendMediaList	MediaDetail[]		附加在尾部的视频（仅 project 为短剧类型可用）
bgMusic	BgMusic		背景音乐
composeTimeline	ComposeTimeline		附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
composeOutput	ComposeOutput		合成输出配置
variety	VarietyConfig		多样性参数
stickerImage	object		角标贴图参数
[+] enabled	bool		是否开启随机角标贴图
endSlate	object		尾贴参数
[+] enabled	bool		是否开启随机尾贴

NarrationDUB

参数	类型	是否必填	描述
per	string	是	音色，取值范围参考音色列表
spd	float		语速，取值范围 [0.5, 2.0]
pit	float		音调，取值范围 [0.5, 2.0]
vol	float		音量，取值范围 [0.5, 2.0]
emotion	string		配音情感，目前仅多感情小帅`per=BV437_streaming`支持 `happy`开心 `sad`悲伤 `angry`生气 `scare`害怕 `hate`讨厌 `surprise`惊讶

NarrationSubtitle

参数	类型	描述
fontFamily	string	字体选择，取值有`Hei`（黑体）,`Song`（宋体）,`Kai`（楷体）。样式参考视频云剪辑/附录/字幕字体
fontSize	int	字体大小，单位为像素。默认与原片字幕大小一致。例如画面高度为1080，fontSize为540，则字体高度占画面高度的一半
fontColor	string	文字颜色，默认白色 #FFFFFF

BgMusic

参数	类型	是否必填	描述
mediaId	string	是	背景音乐媒资id
durationPadding	string(枚举)		背景音乐播放策略，取值： `LOOP` 循环播放，默认值 `ONCE` 单次播放
volume	float		音量，取值范围[0,16]，默认0.2；0表示静音，超过1表示放大声音，小于1表示缩小

MediaDetail

参数	类型	是否必填	描述
mediaId	string	是	媒资 ID
start	float		当前媒资使用的起点，单位秒，默认 0
end	float		当前媒资使用的终点，单位秒，默认到视频末尾

ComposeOutput

参数	类型	是否必填	描述
transitions	object[]		剪辑片段衔接处的转场效果列表
[+] style	string(枚举)	是	转场风格： - `fadeblack`淡出淡入，即前一片段尾部淡出，后一片段开头淡入，渐变颜色为黑色，更多转场见转场示例
screen	string		输出分辨率类型 `custom`自定义输出宽高分辨率，需要设置width、height `follow_source`与源视频分辨率相同 `hori_16_9_1080`横屏16:9 1080P `vert_9_16_1080`竖屏9:16 1080P
width	int		视频合成宽度，默认与剧本所用媒资相同
height	int		视频合成高度，默认与剧本所用媒资相同

VarietyConfig

参数	类型	是否必填	描述
compose	object	是	技术多样性参数
[+] number	int	是	技术多样性任务产出个数，目前1个集锦任务仅支持生成1个多样性任务
[+] switches	object		多样性效果开关配置，不传则使用默认配置
[+][+] enableSpeed	bool		是否启用变速效果（默认 true）
[+][+] enableMirror	bool		是否启用镜像效果（默认 true）
[+][+] enablePeriodicMotion	bool		是否启用周期运动效果（旋转 / 位移，默认 true）
[+][+] enableCrop	bool		是否启用裁剪区域效果（默认 true）
[+][+] enableScale	bool		是否启用缩放效果（默认 true）
[+][+][+] enablePictureInPicture	bool		是否启用画中画效果（默认 true）
[+][+] enableColor	bool		是否启用调色效果（对比度 / 饱和度 / 亮度，默认 true）
[+][+] enableSharpening	bool		是否启用锐化效果（默认 true）
[+][+] enableLightBeam	bool		是否启用光束效果（默认 true）

响应参数

字段	类型	必要性	描述
jobId	string	是	集锦任务ID

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/job/narration HTTP/1.1
2host: vod.bj.baidubce.com
3content-type: application/json
4x-bce-date: 2025-02-18T12:01:34Z
5authorization: bce-auth-v1/ALTAKnRFniUBSDbBSz2oZHUbzt/2025-02-18T12:01:34Z/1800/host/1faf5b1da2420b31a1d9dae46387524db0b0567e3f7dcfc24516ed91ab23fdee
6
7{
8    "projectId": "pjt-fefvg2b11rbt299h",
9    "mediaList": [
10        {
11            "mediaId": "mda-fcyprg3587e3e48e"
12        },
13        {
14            "mediaId": "mda-em6tgfuypbu5txjp",
15            "start": 0,
16            "end": 30
17        }
18    ],
19    "presetIdOrName": "漫剧解说模板",
20    "config": {
21        "appendMediaList": [
22            {
23                "mediaId": "mda-fcyprg3587e3e48e"
24            },
25            {
26                "mediaId": "mda-em6tgfuypbu5txjp",
27                "start": 10,
28                "end": 30.0
29            }
30        ],
31        "bgMusic": {
32            "mediaId": "mda-fkfw9mmizwfsqgpc",
33            "volume": 0.5
34        },
35        "narrationDub": {
36            "per": "BV437_streaming",
37            "spd": 1.2,
38            "pit": 1.1,
39            "vod": 1.3
40        },
41        "composeTimeline": {
42            "videoTracks": [
43                {
44                    "items": [
45                        {
46                            "type": "image",
47                            "mediaId": "mda-wjklew23jijw4ip",
48                            "showDuration": 1.0    // 若填1则表示仅在开头1秒显示；填0或不填则系统默认全程显示
49                        }
50                    ]
51                }
52            ],
53            "textTracks": [
54                {
55                    "items": [
56                        {
57                            "text": "甄嬛传",
58                            "xpos": 0.5,
59                            "ypos": 0.9,
60                            "font":{
61                                "family": "Song",
62                                "size": 65,
63                                "color": "#000000FF"
64                            }
65                        }
66                    ]
67                }
68            ]
69        },
70        "composeOutput": {
71            "screen": "custom",
72            "width": 1080,
73            "height": 1920
74        },
75        "variety": {
76            "compose": {
77                "number": 1
78            }
79        },
80        "stickerImage": {
81          "enabled": true
82        },
83        "endSlate": {
84          "enabled": true
85        }
86    }
87}

响应示例

                JSON
                
                {
  "jobId": "hlt-fefvg2b11rbt299h"
}

1.2 创建视频精剪任务

请求结构

Http

1POST /v2/highlight/job/mashup HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

请求参数

参数	类型	描述
projectId	string	是	项目 ID
mediaList	object[]	是	用于创作的素材视频列表。
[+] mediaId	string	是	媒资 ID
[+] start	float		指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
presetIdOrName	string	是	玩法模板，填入模板名称或者模板 ID： `画面旁白混剪模板 / fkks9v488v5aw46gpqpz` 自动提炼视频高光，将其重组为逻辑连贯的精华短片，并自动生成专业旁白来连贯、补全剧情。 `高光燃剪模板 / fkpks7vkkm0azu7utmmz` 自动提炼视频中的高能瞬间，通过快节奏的随机组合，打造出极具视觉冲击力的高燃爽片。 `剧情顺剪模板 / gadk9xdh17ppsx47w534` 自动梳理视频素材的时间线与逻辑线索，按故事发展顺序进行连贯剪辑，呈现脉络清晰、情感流畅的叙事段落。
config	TaskConfig		创作配置参数。精剪任务的TaskConfig中narration开头的字段无效。

响应参数

字段	类型	必要性	描述
jobId	string	是	集锦任务ID

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/job/mashup HTTP/1.1
2host: vod.bj.baidubce.com
3content-type: application/json
4x-bce-date: 2025-02-18T12:01:34Z
5authorization: bce-auth-v1/ALTAKnRFniUBSDbBSz2oZHUbzt/2025-02-18T12:01:34Z/1800/host/1faf5b1da2420b31a1d9dae46387524db0b0567e3f7dcfc24516ed91ab23fdee
6
7{
8    "projectId": "pjt-fefvg2b11rbt299h",
9    "mediaList": [
10        {
11            "mediaId": "mda-fcyprg3587e3e48e"
12        },
13        {
14            "mediaId": "mda-em6tgfuypbu5txjp",
15            "start": 0,
16            "end": 30
17        }
18    ],
19    "presetIdOrName": "画面旁白混剪模板",
20    "config": {
21        "appendMediaList": [
22            {
23                "mediaId": "mda-fcyprg3587e3e48e"
24            },
25            {
26                "mediaId": "mda-em6tgfuypbu5txjp",
27                "start": 10,
28                "end": 30.0
29            }
30        ],
31        "bgMusic": {
32            "mediaId": "mda-fkfw9mmizwfsqgpc",
33            "volume": 0.5
34        },
35        "composeTimeline": {
36            "videoTracks": [
37                {
38                    "items": [
39                        {
40                            "type": "image",
41                            "mediaId": "mda-wjklew23jijw4ip",
42                            "showDuration": 1.0    // 若填1则表示仅在开头1秒显示；填0或不填则系统默认全程显示
43                        }
44                    ]
45                }
46            ],
47            "textTracks": [
48                {
49                    "items": [
50                        {
51                            "text": "甄嬛传",
52                            "xpos": 0.5,
53                            "ypos": 0.9,
54                            "font": {
55                              "family": "Hei",
56                              "size": 48,
57                              "color": "#00FF55"
58                            }
59                        }
60                    ]
61                }
62            ]
63        },
64        "composeOutput": {
65            "screen": "custom",
66            "width": 1080,
67            "height": 1920
68        },
69        "variety": {
70            "compose": {
71                "number": 1
72            }
73        },
74        "stickerImage": {
75          "enabled": true
76        },
77        "endSlate": {
78          "enabled": true
79        }
80    }
81}

响应示例

                JSON
                
                {
  "jobId": "hlt-fefvg2b11rbt299h"
}

2. 在标准分析项目中创建任务

标准分析项目已经不再推荐，推荐使用深度分析项目。

2.1 创建集锦任务

请求结构

Http

1POST /v2/highlight/job/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

请求参数

参数	类型	是否必填	描述
type	string(枚举)	是	集锦任务类型一键成片：`COMPOSE` 高光检索：`PACK`
projectId	string	是	项目 ID
mediaIdList	string[]		用于创作的素材视频列表。已废弃，请使用`mediaList`
mediaList	object[]	是	用于创作的素材视频列表。
[+] mediaId	string	是	媒资 ID
[+] start	float		指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
autoPack	bool		当 `type=PACK` 时，该参数代表在创作剧本之后是否自动打包，默认`false`
config	NormalTaskConfig		创作配置。

NormalTaskConfig

参数	类型	是否必填	描述
narrationDub	NarrationDUB	是	解说配音配置
narrationSubtitle	NarrationSubtitle		解说字幕配置。不填则默认与原片字幕位置和大小一致
appendMediaList	MediaDetail[]		附加在尾部的视频（仅 project 为短剧类型可用）
bgMusic	BgMusic		背景音乐
composeTimeline	ComposeTimeline		附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
composeOutput	ComposeOutput		合成输出配置
variety	VarietyConfig		多样性参数
stickerImage	object		角标贴图参数
[+] enabled	bool		是否开启随机角标贴图
endSlate	object		尾贴参数
[+] enabled	bool		是否开启随机尾贴
highlightSearch	object		当 `type=PACK` 时，表示高光片段检索配置
[+] style	string(枚举)		高光检索类型： `DEFAULT` 系统内置策略； `CUSTOM` 用户自定义策略
[+] expectedContent	string		当 `style=CUSTOM` 时，表示检索词（不填则默认系统内置策略），比如“孙悟空一棒打翻了炼丹炉”
header	object		当 `type=COMPOSE` 时，表示片头配置。不填或为`null`则不生成定制化片头
[+] style	string(枚举)	是	支持风格： * `ORIGIN`黄金片头（纯原片）
[+] expectedDurationInSeconds	int		期望的背景介绍时长，单位秒，默认 12 秒，取值范围[5,15]
[+] expectedContent	string		期望的黄金片头剧情描述，不填则默认系统内置策略
body	object	是	当 `type=COMPOSE` 时，表示正片配置
[+] style	string(枚举)	是	支持风格： * `NARRATION_ORIGIN_MIX_LINEAR` （默认）解说/原片穿插之线性叙事
[+] expectedContent	string		期望文本

响应参数

字段	类型	必要性	描述
jobId	string	是	集锦任务ID

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/job/script HTTP/1.1
2host: vod.bj.baidubce.com
3content-type: application/json
4x-bce-date: 2025-02-18T12:01:34Z
5authorization: bce-auth-v1/ALTAKnRFniUBSDbBSz2oZHUbzt/2025-02-18T12:01:34Z/1800/host/1faf5b1da2420b31a1d9dae46387524db0b0567e3f7dcfc24516ed91ab23fdee
6
7{
8    "type": "COMPOSE",
9    "projectId": "pjt-fefvg2b11rbt299h",
10    "mediaList": [
11        {
12            "mediaId": "mda-fcyprg3587e3e48e"
13        },
14        {
15            "mediaId": "mda-em6tgfuypbu5txjp",
16            "start": 0,
17            "end": 30
18        }
19    ],
20    "config": {
21        "header": {
22            "style": "ORIGIN",
23            "expectedDurationInSeconds": 10,
24            "expectedContent": "武松喝醉了酒"
25        },
26        "body": {
27            "style": "NARRATION_ORIGIN_MIX_LINEAR"
28        },
29        "appendMediaList": [
30            {
31                "mediaId": "mda-fcyprg3587e3e48e"
32            },
33            {
34                "mediaId": "mda-em6tgfuypbu5txjp",
35                "start": 10,
36                "end": 30.0
37            }
38        ],
39        "narrationDub": {
40            "per": "BV411_streaming"
41        },
42        "composeTimeline": {
43            "videoTracks": [
44                {
45                    "items": [
46                        {
47                            "mediaId": "mda-wjklew23jijw4ip",
48                            "type": "image",
49                            "showDuration": 1.0    // 若填1则表示开头1秒显示；填0或不填则系统默认全程显示
50                        }
51                    ]
52                }
53            ],
54            "textTracks": [
55                {
56                    "items": [
57                        {
58                            "text": "甄嬛传",
59                            "xpos": 0.5,
60                            "ypos": 0.9,
61                            "font": {
62                              "family": "Kai",
63                              "size": 20,
64                              "color": "#FFFFFFFF"
65                            }
66                        }
67                    ]
68                }
69            ]
70        },
71        "composeOutput": {
72            "width": 1080,
73            "height": 1920
74        },
75        "variety": {
76            "compose": {
77                "number": 1
78            }
79        },
80        "stickerImage": {
81          "enabled": true
82        },
83        "endSlate": {
84          "enabled": true
85        }
86    }
87}

响应示例

                JSON
                
                {
  "jobId": "hlt-fefvg2b11rbt299h"
}

3. 查询集锦任务

请求结构

Http

1GET /v2/highlight/job/{jobId} HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

响应参数

参数	类型	必填	描述
jobId	string	是	集锦任务 id
projectId	string	是	项目 id
name	string	是	集锦任务名称
type	string(枚举)	是	集锦任务类型
mediaList	object[]	是	媏资信息列表
[+] mediaId	string	是	媒资 ID
[+] start	float	是	起始时间
[+] end	float	是	结束时间
config	NormalTaskConfig	是	创作配置，返回与传入的一致
updateTime	string	是	最近更新时间
createTime	string	是	创建时间
status	string(枚举)	是	导出状态，`PENDING`，`RUNNING`，`SUCCESS`，`FAILED`
scriptStatus	string(枚举)	是	创作状态，`PENDING`，`RUNNING`，`SUCCESS`，`FAILED`
script	object	是	剧本信息
[+] segments	object	是	剧本片段
[+][+] mediaId	string	是	媒资 id
[+][+] startTime	float	是	当前片段在集锦作品中的播放起点，单位秒
[+][+] endTime	float	是	当前片段在集锦作品中的播放终点，单位秒
[+][+] textType	string(枚举)	是	文本类型：`subtitle`，`narration`
[+][+] text	string	是	文本内容，字幕或解说
autoPack	bool	是	当 `type=PACK` 时，该参数代表在创作剧本之后是否自动打包，默认`false`
output	object		输出结构
[+] url	string		集锦结果，仅集锦任务`status=SUCCESS`时返回结果
[+] coverUrl	string		集锦封面图，仅集锦任务`status=SUCCESS`时返回结果
[+] varietyList	object[]		多样化视频输出信息
[+][+] jobId	string		多样化的集锦任务id
[+][+] url	string		多样化视频 url
[+][+] coverUrl	string		多样化视频封面 url
[+][+] status	string		多样化视频任务状态（仅SUCCESS时生成url）

4. 重跑集锦任务

请求结构

Http

1POST /v2/highlight/job/rerun HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

请求参数

字段	类型	必要性	解释
jobId	string	是	要重跑的任务id

请求示例

Http

1POST https://vod.bj.baidubce.com/v2/highlight/job/rerun HTTP/1.1
2host: vod.bj.baidubce.com
3content-type: application/json
4x-bce-date: 2025-02-18T12:01:34Z
5authorization: bce-auth-v1/ALTAKnRFniUBSDbBSz2oZHUbzt/2025-02-18T12:01:34Z/1800/host/xxxxxxx
6
7{
8    "jobId": "hlt-fefvg2b11rbt299h"
9}

5. 删除集锦任务

在智能集锦中，对于已完成的任务允许删除，其相关的资源也会被删除，包括输出视频、封面图、CDN缓存等。一旦删除，不可恢复，请谨慎使用！

请求结构

Http

1POST /v2/highlight/job/delete HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>

请求参数

字段	类型	必要性	解释
jobIdList	string[]	是	要删除的任务id列表，最多填写1000个

请求示例

Http

1POST https://vod.bj.baidubce.com/v2/highlight/job/delete HTTP/1.1
2host: vod.bj.baidubce.com
3content-type: application/json
4x-bce-date: 2025-02-18T12:01:34Z
5authorization: bce-auth-v1/ALTAKnRFniUBSDbBSz2oZHUbzt/2025-02-18T12:01:34Z/1800/host/xxxxxxx
6
7{
8    "jobIdList": [
9        "hlt-fefvg2b11rbt299h",
10        "hlt-ixk7u4e41m0y5d6g"
11    ]
12}

附件

模板支持变量对照表

✅表示模板支持该参数，❌表示模板不支持该参数

模板名称	模板 ID	headDuration (黄金片头时长)
穿插解说模板	`fkkskynwqcjh1ned8f5j`	❌
含黄金片头模板	`fkpqe3m4basu644zjmkx`	✅
漫剧解说模板	`fkksi4mv4j2iti9cr00z`	❌
视频重构模板	`fksx93f3yx891drgknet`	❌
爆款解说模板	`fmcwq007crkxaiqmvbfx`	❌

剧本管理

音色列表

智能点播平台 VOD

集锦任务

1. 在深度分析项目中创建任务

1.1 创建视频解说任务

请求结构

请求参数

TaskConfig

NarrationDUB

NarrationSubtitle

BgMusic

MediaDetail

ComposeOutput

VarietyConfig

响应参数

请求示例

响应示例

1.2 创建视频精剪任务

请求结构

请求参数

响应参数

请求示例

响应示例

2. 在标准分析项目中创建任务

2.1 创建集锦任务

请求结构

请求参数

NormalTaskConfig

响应参数

请求示例

响应示例

3. 查询集锦任务

请求结构

响应参数

4. 重跑集锦任务

请求结构

请求参数

请求示例

5. 删除集锦任务

请求结构

请求参数

请求示例

附件

模板支持变量对照表