集锦任务

更新时间：2025-11-21

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

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

1. 创建集锦任务

为了提升效果，我们将集锦任务对深度分析任务进行适配并增加视频精剪类型和多重玩法，因此根据项目视频分析模式（标准分析 understandMode=NORMAL、深度分析understandMode=MULTIMODAL）对 API 进行了区分。
强烈推荐您进行深度分析并调用相应集锦任务 API，因为标准分析流程后续则不继续迭代更新。

1.1 深度分析项目

深度分析项目中集锦任务主要分为两类，视频解说类和视频精剪类（无解说），每个类型均有多种玩法（持续新增迭代），如若玩法无法满足您的需求，可以联系我们。

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	是	RequestBody参数	项目 ID
name	string	是	RequestBody参数	集锦任务名称，长度 [1, 100]
mediaList	object[]	是	RequestBody参数	用于创作的素材视频列表。
[+] mediaId	string	是	RequestBody参数	媒资 ID
[+] start	float		RequestBody参数	指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		RequestBody参数	指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
presetIdOrName	string	是	RequestBody参数	玩法模板，填入模板名称或者模板 ID： `穿插解说模板 / fkkskynwqcjh1ned8f5j` 以线性叙事为原则的穿插解说 `含黄金片头的穿插解说模板 / fkpqe3m4basu644zjmkx` 以线性叙事为原则的穿插解说 `漫剧解说模板 / fkksi4mv4j2iti9cr00z` 专为漫剧解说定制，自带吸睛片头与强节奏卡点。全程高密度解说，无缝衔接剧情。 `视频重构模板 / fksx93f3yx891drgknet`本模板旨在帮助您将原始的解说视频，提炼并重构为结构清晰、重点突出、语言流畅的新视频。
config	object	是	RequestBody参数	创作配置参数
[+] narrationDub	object	是	RequestBody参数	解说配音配置
[+][+] per	string	是	RequestBody参数	音色，取值范围参考音色列表
[+][+] spd	float		RequestBody参数	语速，取值范围 [0.5, 2.0]
[+][+] pit	float		RequestBody参数	音调，取值范围 [0.5, 2.0]
[+][+] vol	float		RequestBody参数	音量，取值范围 [0.5, 2.0]
[+][+] emotion	string		RequestBody参数	配音情感，目前仅多感情小帅`per=BV437_streaming`支持 `happy`开心 `sad`悲伤 `angry`生气 `scare`害怕 `hate`讨厌 `surprise`惊讶
[+] narrationSubtitle	object		RequestBody参数	解说字幕配置。不填则默认与原片字幕位置和大小一致
[+][+] fontFamily	string		RequestBody参数	字体选择，默认`Noto Sans SC Medium`，全部支持字体见视频云剪辑/附录/字幕字体
[+][+] fontSize	int		RequestBody参数	字体大小，单位为像素。默认与原片字幕大小一致。例如画面高度为1080，fontSize为540，则字体高度占画面高度的一半
[+][+] fontColor	string		RequestBody参数	文字颜色，默认白色 #FFFFFF
[+] appendMediaList	object[]		RequestBody参数	附加在尾部的视频（仅 project 为短剧类型可用）
[+][+] mediaId	string	是	RequestBody参数	媒资 ID
[+][+] start	float		RequestBody参数	当前媒资使用的起点，单位秒，默认 0
[+][+] end	float		RequestBody参数	当前媒资使用的终点，单位秒，默认到视频末尾
[+] bgMusic	object		RequestBody参数	背景音乐
[+][+] mediaId	string	是	RequestBody参数	背景音乐媒资id
[+][+] durationPadding	string(枚举)		RequestBody参数	背景音乐播放策略，取值： `LOOP` 循环播放，默认值 `ONCE` 单次播放
[+][+] volume	float		RequestBody参数	音量，取值范围[0,16]，默认0.2；0表示静音，超过1表示放大声音，小于1表示缩小
[+] composeTimeline	ComposeTimeline		RequestBody参数	附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
[+] composeOutput	object		RequestBody参数	合成输出配置
[+][+] transitions	object[]		RequestBody参数	剪辑片段衔接处的转场效果列表
[+][+][+] style	string(枚举)	是	RequestBody参数	转场风格： - `fadeblack`淡出淡入，即前一片段尾部淡出，后一片段开头淡入，渐变颜色为黑色
[+][+] screen	string		RequestBody参数	输出分辨率类型 `custom`自定义输出宽高分辨率，需要设置width、height `follow_source`与源视频分辨率相同 `hori_16_9_1080`横屏16:9 1080P `vert_9_16_1080`竖屏9:16 1080P
[+][+] width	int		RequestBody参数	视频合成宽度，默认与剧本所用媒资相同
[+][+] height	int		RequestBody参数	视频合成高度，默认与剧本所用媒资相同
[+] variety	object		RequestBody参数	多样性参数
[+][+] compose	object	是	RequestBody参数	技术多样性参数
[+][+][+] number	int	是	RequestBody参数	技术多样性任务产出个数，目前1个集锦任务仅支持生成1个多样性任务
[+] stickerImage	object		RequestBody参数	角标贴图参数
[+][+] enabled	bool		RequestBody参数	是否开启随机角标贴图
[+] endSlate	object		RequestBody参数	尾贴参数
[+][+] enabled	bool		RequestBody参数	是否开启随机尾贴

响应参数

字段	类型	必要性	描述
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    "name": "这是我的第一个集锦作品",
10    "mediaList": [
11        {
12            "mediaId": "mda-fcyprg3587e3e48e"
13        },
14        {
15            "mediaId": "mda-em6tgfuypbu5txjp",
16            "start": 0,
17            "end": 30
18        }
19    ],
20    "presetIdOrName": "漫剧解说模板",
21    "config": {
22        "appendMediaList": [
23            {
24                "mediaId": "mda-fcyprg3587e3e48e"
25            },
26            {
27                "mediaId": "mda-em6tgfuypbu5txjp",
28                "start": 10,
29                "end": 30.0
30            }
31        ],
32        "bgMusic": {
33            "mediaId": "mda-fkfw9mmizwfsqgpc",
34            "volume": 0.5
35        },
36        "narrationDub": {
37            "per": "BV437_streaming",
38            "spd": 1.2,
39            "pit": 1.1,
40            "vod": 1.3
41        },
42        "composeTimeline": {
43            "videoTracks": [
44                {
45                    "videoItems": [
46                        {
47                            "mediaId": "mda-wjklew23jijw4ip",
48                            "type": "image",
49                            "showDuration": 1.0    // 若填1则表示开头1秒显示；填0或不填则系统默认全程显示
50                        }
51                    ]
52                }
53            ],
54            "subtitleTracks": [
55                {
56                    "subtitleItems": [
57                        {
58                            "text": "甄嬛传",
59                            "xpos": 0.5,
60                            "ypos": 0.9,
61                            "fontFamily": "楷体",
62                            "fontSize": 48,
63                            "fontColor": "#00FF55"
64                        }
65                    ]
66                }
67            ]
68        },
69        "composeOutput": {
70            "screen": "custom",
71            "width": 1080,
72            "height": 1920
73        },
74        "variety": {
75            "compose": {
76                "number": 1
77            }
78        },
79        "stickerImage": {
80          "enabled": true
81        },
82        "endSlate": {
83          "enabled": true
84        }
85    }
86}

响应示例

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

1.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	是	RequestBody参数	项目 ID
name	string	是	RequestBody参数	集锦任务名称，长度 [1, 100]
mediaList	object[]	是	RequestBody参数	用于创作的素材视频列表。
[+] mediaId	string	是	RequestBody参数	媒资 ID
[+] start	float		RequestBody参数	指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		RequestBody参数	指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
presetIdOrName	string	是	RequestBody参数	玩法模板，填入模板名称或者模板 ID： `画面旁白混剪模板 / fkks9v488v5aw46gpqpz` 自动提炼视频高光，将其重组为逻辑连贯的精华短片，并自动生成专业旁白来连贯、补全剧情。 `高光燃剪模板 / fkpks7vkkm0azu7utmmz` 自动提炼视频中的高能瞬间，通过快节奏的随机组合，打造出极具视觉冲击力的高燃爽片。
config	object		RequestBody参数	创作配置参数
[+] appendMediaList	object[]		RequestBody参数	附加在尾部的视频（仅 project 为短剧类型可用）
[+][+] mediaId	string	是	RequestBody参数	媒资 ID
[+][+] start	float		RequestBody参数	当前媒资使用的起点，单位秒，默认 0
[+][+] end	float		RequestBody参数	当前媒资使用的终点，单位秒，默认到视频末尾
[+] bgMusic	object		RequestBody参数	背景音乐
[+][+] mediaId	string	是	RequestBody参数	背景音乐媒资id
[+][+] durationPadding	string(枚举)		RequestBody参数	背景音乐播放策略，取值： `LOOP` 循环播放，默认值 `ONCE` 单次播放
[+][+] volume	float		RequestBody参数	音量，取值范围[0,16]，默认0.2；0表示静音，超过1表示放大声音，小于1表示缩小
[+] composeTimeline	ComposeTimeline		RequestBody参数	附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
[+] composeOutput	object		RequestBody参数	合成输出配置
[+][+] transitions	object[]		RequestBody参数	剪辑片段衔接处的转场效果列表
[+][+][+] style	string(枚举)	是	RequestBody参数	转场风格： - `fadeblack`淡出淡入，即前一片段尾部淡出，后一片段开头淡入，渐变颜色为黑色
[+][+] screen	string		RequestBody参数	输出分辨率类型 `custom`自定义输出宽高分辨率，需要设置width、height `follow_source`与源视频分辨率相同 `hori_16_9_1080`横屏16:9 1080P `vert_9_16_1080`竖屏9:16 1080P
[+][+] width	int		RequestBody参数	视频合成宽度，默认与剧本所用媒资相同
[+][+] height	int		RequestBody参数	视频合成高度，默认与剧本所用媒资相同
[+] variety	object		RequestBody参数	多样性参数
[+][+] compose	object	是	RequestBody参数	技术多样性参数
[+][+][+] number	int	是	RequestBody参数	技术多样性任务产出个数，目前1个集锦任务仅支持生成1个多样性任务
[+] stickerImage	object		RequestBody参数	角标贴图参数
[+][+] enabled	bool		RequestBody参数	是否开启随机角标贴图
[+] endSlate	object		RequestBody参数	尾贴参数
[+][+] enabled	bool		RequestBody参数	是否开启随机尾贴

响应参数

字段	类型	必要性	描述
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    "name": "这是我的第一个集锦作品",
10    "mediaList": [
11        {
12            "mediaId": "mda-fcyprg3587e3e48e"
13        },
14        {
15            "mediaId": "mda-em6tgfuypbu5txjp",
16            "start": 0,
17            "end": 30
18        }
19    ],
20    "presetIdOrName": "画面旁白混剪模板",
21    "config": {
22        "appendMediaList": [
23            {
24                "mediaId": "mda-fcyprg3587e3e48e"
25            },
26            {
27                "mediaId": "mda-em6tgfuypbu5txjp",
28                "start": 10,
29                "end": 30.0
30            }
31        ],
32        "bgMusic": {
33            "mediaId": "mda-fkfw9mmizwfsqgpc",
34            "volume": 0.5
35        },
36        "composeTimeline": {
37            "videoTracks": [
38                {
39                    "videoItems": [
40                        {
41                            "mediaId": "mda-wjklew23jijw4ip",
42                            "type": "image",
43                            "showDuration": 1.0    // 若填1则表示开头1秒显示；填0或不填则系统默认全程显示
44                        }
45                    ]
46                }
47            ],
48            "subtitleTracks": [
49                {
50                    "subtitleItems": [
51                        {
52                            "text": "甄嬛传",
53                            "xpos": 0.5,
54                            "ypos": 0.9,
55                            "fontFamily": "楷体",
56                            "fontSize": 48,
57                            "fontColor": "#00FF55"
58                        }
59                    ]
60                }
61            ]
62        },
63        "composeOutput": {
64            "screen": "custom",
65            "width": 1080,
66            "height": 1920
67        },
68        "variety": {
69            "compose": {
70                "number": 1
71            }
72        },
73        "stickerImage": {
74          "enabled": true
75        },
76        "endSlate": {
77          "enabled": true
78        }
79    }
80}

响应示例

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

1.2 标准分析项目

若需要用最新的玩法，推荐调用深度分析对应的创建集锦任务API。标准分析项目相关 API 后续不再迭代。深度分析项目创建集锦任务

1.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(枚举)	是	RequestBody参数	集锦任务类型一键成片：`COMPOSE` 高光检索：`PACK`
projectId	string	是	RequestBody参数	项目 ID
name	string	是	RequestBody参数	集锦任务名称
mediaIdList	string[]		RequestBody参数	用于创作的素材视频列表。已废弃，请使用`mediaList`
mediaList	object[]	是	RequestBody参数	用于创作的素材视频列表。
[+] mediaId	string	是	RequestBody参数	媒资 ID
[+] start	float		RequestBody参数	指定当前媒资要使用的开始时间，单位秒，默认0
[+] end	float		RequestBody参数	指定当前媒资要使用的结束时间，单位秒，默认到素材末尾
autoPack	bool		RequestBody参数	当 `type=PACK` 时，该参数代表在创作剧本之后是否自动打包，默认`false`
config	object		RequestBody参数	创作配置
[+] highlightSearch	object		RequestBody参数	当 `type=PACK` 时，表示高光片段检索配置
[+][+] style	string(枚举)		RequestBody参数	高光检索类型： `DEFAULT` 系统内置策略； `CUSTOM` 用户自定义策略
[+][+] expectedContent	string		RequestBody参数	当 `style=CUSTOM` 时，表示检索词（不填则默认系统内置策略），比如“孙悟空一棒打翻了炼丹炉”
[+] header	object		RequestBody参数	当 `type=COMPOSE` 时，表示片头配置。不填或为`null`则不生成定制化片头
[+][+] style	string(枚举)	是	RequestBody参数	支持风格： * `ORIGIN`黄金片头（纯原片）
[+][+] expectedDurationInSeconds	int		RequestBody参数	期望的背景介绍时长，单位秒，默认 12 秒，取值范围[5,15]
[+][+] expectedContent	string		RequestBody参数	期望的黄金片头剧情描述，不填则默认系统内置策略
[+] body	object	是	RequestBody参数	当 `type=COMPOSE` 时，表示正片配置
[+][+] style	string(枚举)	是	RequestBody参数	支持风格： * `NARRATION_ORIGIN_MIX_LINEAR` （默认）解说/原片穿插之线性叙事
[+][+] expectedContent	string		RequestBody参数	期望文本
[+] narrationDub	object	是	RequestBody参数	解说配音配置
[+][+] per	string	是	RequestBody参数	音色，取值范围参考音色列表
[+][+] spd	float		RequestBody参数	语速，取值范围 [0.5, 2.0]
[+][+] pit	float		RequestBody参数	音调，取值范围 [0.5, 2.0]
[+][+] vol	float		RequestBody参数	音量，取值范围 [0.5, 2.0]
[+][+] emotion	string		RequestBody参数	配音情感，目前仅多感情小帅`per=BV437_streaming`支持 `happy`开心，默认情感 `sad`悲伤 `angry`生气 `scare`害怕 `hate`讨厌 `surprise`惊讶
[+] narrationSubtitle	object		RequestBody参数	解说字幕配置。不填则默认与原片字幕位置和大小一致
[+][+] fontFamily	string		RequestBody参数	字体选择，默认`Noto Sans SC Medium`，全部支持字体见视频云剪辑/附录/字幕字体
[+][+] fontSize	int		RequestBody参数	字体大小，单位为像素。默认与原片字幕大小一致。例如画面高度为1080，fontSize为540，则字体高度占画面高度的一半
[+][+] fontColor	string		RequestBody参数	文字颜色，默认白色 #FFFFFF
[+] appendMediaList	object[]		RequestBody参数	附加在尾部的视频（仅 project 为短剧类型可用）
[+][+] mediaId	string	是	RequestBody参数	媒资 ID
[+][+] start	float		RequestBody参数	当前媒资使用的起点，单位秒，默认 0
[+][+] end	float		RequestBody参数	当前媒资使用的终点，单位秒，默认到视频末尾
[+] bgMusic	object		RequestBody参数	背景音乐
[+][+] mediaId	string	是	RequestBody参数	背景音乐媒资id
[+][+] durationPadding	string(枚举)		RequestBody参数	背景音乐播放策略，取值： `LOOP` 循环播放，默认值 `ONCE` 单次播放
[+][+] volume	float		RequestBody参数	音量，取值范围[0,16]，默认0.2；0表示静音，超过1表示放大声音，小于1表示缩小
[+] composeTimeline	ComposeTimeline		RequestBody参数	附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
[+] composeOutput	object		RequestBody参数	合成输出配置
[+][+] transitions	object[]		RequestBody参数	剪辑片段衔接处的转场效果列表
[+][+][+] style	string(枚举)	是	RequestBody参数	转场风格： - `fadeblack`淡出淡入，即前一片段尾部淡出，后一片段开头淡入，渐变颜色为黑色
[+][+] screen	string		RequestBody参数	输出分辨率类型 `custom`自定义输出宽高分辨率，需要设置width、height `follow_source`与源视频分辨率相同 `hori_16_9_1080`横屏16:9 1080P `vert_9_16_1080`竖屏9:16 1080P
[+][+] width	int		RequestBody参数	视频合成宽度，默认与剧本所用媒资相同
[+][+] height	int		RequestBody参数	视频合成高度，默认与剧本所用媒资相同
[+] variety	object		RequestBody参数	多样性参数
[+][+] compose	object	是	RequestBody参数	技术多样性参数
[+][+][+] number	int	是	RequestBody参数	技术多样性任务产出个数，目前1个集锦任务仅支持生成1个多样性任务
[+] stickerImage	object		RequestBody参数	角标贴图参数
[+][+] enabled	bool		RequestBody参数	是否开启随机角标贴图
[+] endSlate	object		RequestBody参数	尾贴参数
[+][+] enabled	bool		RequestBody参数	是否开启随机尾贴

响应参数

字段	类型	必要性	描述
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    "name": "这是我的第一个集锦作品",
11    "mediaList": [
12        {
13            "mediaId": "mda-fcyprg3587e3e48e"
14        },
15        {
16            "mediaId": "mda-em6tgfuypbu5txjp",
17            "start": 0,
18            "end": 30
19        }
20    ],
21    "config": {
22        "header": {
23            "style": "ORIGIN",
24            "expectedDurationInSeconds": 10,
25            "expectedContent": "武松喝醉了酒"
26        },
27        "body": {
28            "style": "NARRATION_ORIGIN_MIX_LINEAR"
29        },
30        "appendMediaList": [
31            {
32                "mediaId": "mda-fcyprg3587e3e48e"
33            },
34            {
35                "mediaId": "mda-em6tgfuypbu5txjp",
36                "start": 10,
37                "end": 30.0
38            }
39        ],
40        "narrationDub": {
41            "per": "BV411_streaming"
42        },
43        "composeTimeline": {
44            "videoTracks": [
45                {
46                    "videoItems": [
47                        {
48                            "mediaId": "mda-wjklew23jijw4ip",
49                            "type": "image",
50                            "showDuration": 1.0    // 若填1则表示开头1秒显示；填0或不填则系统默认全程显示
51                        }
52                    ]
53                }
54            ],
55            "subtitleTracks": [
56                {
57                    "subtitleItems": [
58                        {
59                            "text": "甄嬛传",
60                            "xpos": 0.5,
61                            "ypos": 0.9,
62                            "fontFamily": "楷体",
63                            "fontSize": 48,
64                            "fontColor": "#00FF55"
65                        }
66                    ]
67                }
68            ]
69        },
70        "composeOutput": {
71            "width": 1080,
72            "height": 1920
73        },
74        "variety": {
75            "compose": {
76                "number": 1
77            }
78        },
79        "stickerImage": {
80          "enabled": true
81        },
82        "endSlate": {
83          "enabled": true
84        }
85    }
86}

响应示例

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

2. 查询集锦任务

请求结构

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	是	结束时间
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`
config	object	是	创作配置，返回与传入的一致
[+] 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		期望文本
[+] appendMediaList	object[]		附加在尾部的视频（仅 project 为短剧类型可用）
[+][+] mediaId	string		媒资 ID
[+][+] start	float		当前媒资使用的起点，单位秒，默认 0
[+][+] end	float		当前媒资使用的终点，单位秒，默认到视频末尾
[+] narrationDub	object		解说配音配置
[+][+] per	string		音色
[+][+] spd	float		语速
[+][+] pit	float		音调
[+][+] vol	float		音量
[+][+] emotion	string		配音情感
[+] narrationSubtitle	object		解说字幕配置。不填则默认与原片字幕位置和大小一致
[+][+] fontFamily	string		字体选择，默认`Noto Sans SC Medium`，全部支持字体见视频云剪辑/附录/字幕字体
[+][+] fontSize	int		字体大小，单位为像素。默认与原片字幕大小一致。例如画面高度为1080，fontSize为540，则字体高度占画面高度的一半
[+][+] fontColor	string		文字颜色，默认白色 #FFFFFF
[+] bgMusic	object		背景音乐
[+][+] mediaId	string		背景音乐媒资id
[+][+] durationPadding	string(枚举)		背景音乐播放策略，取值：LOOP（循环播放，默认行为）, ONCE（单次播放）
[+][+] volume	float		音量，取值范围[0,16]，默认0.2；0表示静音，超过1表示放大声音，小于1表示缩小
[+] composeTimeline	ComposeTimeline		附加的剪辑轨道。您可以为集锦作品额外添加贴图、logo、马赛克、字幕等。注意：由于AI创作的剪辑时长无法事先得知，所以`ComposeTimline`中出现的`showDuration`字段可以不填，系统将自动设为全长
[+] composeOutput	object		合成输出配置
[+][+] transitions	object[]		剪辑片段衔接处的转场效果列表
[+][+][+] style	string(枚举)		转场风格： - `fadeblack`淡出淡入
[+][+] width	int		视频合成宽度，默认与剧本所用媒资相同
[+][+] height	int		视频合成高度，默认与剧本所用媒资相同
[+] variety	object		多样性参数
[+][+] compose	object		技术多样性参数
[+][+][+] number	int		技术多样性任务产出个数，目前1个集锦任务仅支持生成1个多样性任务
[+] stickerImage	object		角标贴图参数
[+][+] enabled	bool		是否开启随机角标贴图
[+] endSlate	object		尾贴参数
[+][+] enabled	bool		是否开启随机尾贴
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）

3. 重跑集锦任务

请求结构

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}

4. 删除集锦任务

在智能集锦中，对于已完成的任务允许删除，其相关的资源也会被删除，包括输出视频、封面图、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}

剧本管理

音色列表

百度智能云

智能点播平台 VOD

智能点播平台 VOD

集锦任务

1. 创建集锦任务

1.1 深度分析项目

1.1.1 创建视频解说任务

请求结构

请求参数

响应参数

请求示例

响应示例

1.1.2 创建视频精剪任务

请求结构

请求参数

响应参数

请求示例

响应示例

1.2 标准分析项目

1.2.1 创建集锦任务

请求结构

请求参数

响应参数

请求示例

响应示例

2. 查询集锦任务

请求结构

响应参数

3. 重跑集锦任务

请求结构

请求参数

请求示例

4. 删除集锦任务

请求结构

请求参数

请求示例