集锦任务
更新时间：2025-05-13
在智能集锦任一项目内，您可以选中若干个视频进行集锦创作。 发起集锦任务后，系统将根据您的参数配置，进行相应的文案创作和视频剪辑。
关于请求头与响应头，请参考公共请求头与响应头。
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[] | 是 | 集锦任务解说选集。 |
| autoPack | bool | 当type=PACK时，该参数代表在创作剧本之后是否自动打包，默认false |
|
| dub | object | 当type=COMPOE时，必填，表示配音参数 | |
| [+] 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 "mediaIdList": [
12 "mda-fefvg2b11rbt299h"
13 ],
14 "dub": {
15 "per": "zh_female_wenrouxiaoya_moon_bigtts"
16 }
17}响应示例
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 | 创建时间 |