集锦任务
更新时间：2025-08-22
在智能集锦任一项目内，您可以选中若干个视频进行集锦创作。 发起集锦任务后，系统将根据您的参数配置，进行相应的文案创作和视频剪辑。
关于请求头与响应头，请参考公共请求头与响应头。
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 |
| name | string | 是 | 集锦任务名称 |
| mediaIdList | string[] | 用于创作的素材视频列表。 已废弃，请使用mediaList |
|
| mediaList | object[] | 是 | 用于创作的素材视频列表。 |
| [+] mediaId | string | 是 | 媒资 ID |
| [+] start | float | 指定当前媒资要使用的开始时间，单位秒，默认0 | |
| [+] end | float | 指定当前媒资要使用的结束时间，单位秒，默认到素材末尾 | |
| autoPack | bool | 当type=PACK时，该参数代表在创作剧本之后是否自动打包，默认false |
|
| config | object | 是 | 创作配置 |
| [+] header | object | 当 type=COMPOSE 时，表示片头配置。不填或为null则不生成定制化片头 |
|
| [+][+] style | string(枚举) | 是 | 支持风格： * ORIGIN黄金片头（纯原片） |
| [+][+] expectedDurationInSeconds | int | 期望的背景介绍时长，单位秒，默认 12 秒 | |
| [+][+] expectedContent | string | 期望的黄金片头剧情描述，不填则默认系统内置策略 | |
| [+] body | object | 是 | 当 type=COMPOSER 时，表示正片配置 |
| [+][+] style | string(枚举) | 是 | 支持风格： * NARRATION_ORIGIN_MIX_LINEAR 解说/原片穿插之线性叙事（默认） |
| [+] appendMediaList | object[] | 附加在尾部的视频（仅 project 为短剧类型可用） | |
| [+][+] mediaId | string | 是 | 媒资 ID |
| [+][+] start | float | 当前媒资使用的起点，单位秒，默认 0 | |
| [+][+] end | float | 当前媒资使用的终点，单位秒，默认到视频末尾 | |
| [+] narrationDub | object | 解说配音配置，当所选配置含有配音解说时则必填 | |
| [+][+] per | string | 是 | 音色选择 |
| [+] composeOutput | object | 合成输出配置 | |
| [+][+] width | int | 视频合成宽度，默认与剧本所用媒资相同 | |
| [+][+] height | int | 视频合成高度，默认与剧本所用媒资相同 | |
| dub | object | 当type=COMPOE时，必填，表示配音参数。已废弃，请使用config.narrationDub |
|
| [+] per | string(枚举) | 是 | 音色选择 |
其中配音音色取值范围如下：
- 小帅：
BV411_streaming - 阿龙：
4114 - 度悠然：
6205 - 度清豪：
6546 - 和蔼奶奶：
ICL_zh_female_heainainai_tob - 邻居阿姨：
ICL_zh_female_linjuayi_tob - 温柔小雅：
zh_female_wenrouxiaoya_moon_bigtts - 天才童声：
zh_male_tiancaitongsheng_mars_bigtts - 猴哥：
zh_male_sunwukong_mars_bigtts - 熊二：
zh_male_xionger_mars_bigtts - 佩奇猪：
zh_female_peiqi_mars_bigtts - 武则天：
zh_female_wuzetian_mars_bigtts - 顾姐：
zh_female_gujie_mars_bigtts - 樱桃丸子：
zh_female_yingtaowanzi_mars_bigtts - 广告解说：
zh_male_chunhui_mars_bigtts - 少儿故事：
zh_female_shaoergushi_mars_bigtts - 四郎：
zh_male_silang_mars_bigtts - 磁性解说男声/Morgan：
zh_male_jieshuonansheng_mars_bigtts - 鸡汤妹妹/Hope：
zh_female_jitangmeimei_mars_bigtts - 贴心女声/Candy：
zh_female_tiexinnvsheng_mars_bigtts - 俏皮女声：
zh_female_qiaopinvsheng_mars_bigtts - 萌丫头/Cutey：
zh_female_mengyatou_mars_bigtts
响应参数
| 字段 | 类型 | 必要性 | 描述 |
|---|---|---|---|
| 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 "composeOutput": {
44 "width": 1080,
45 "height": 1920
46 }
47 }
48}响应示例
JSON
1{
2 "jobId": "hlt-fefvg2b11rbt299h"
3}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(枚举) | 集锦任务类型 |
| 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 | 文本内容，字幕或解说 |
| output | object | 输出结构 |
| [+] url | string | 集锦结果 |
| [+] coverUrl | string | 集锦封面图 |
| mediaList | MediaDetail[] | 媏资信息列表 |
| updateTime | string | 最近更新时间 |
| createTime | string | 创建时间 |