剧本管理
更新时间：2026-02-03
智能集锦的每个项目中，对于理解完成的视频，都会给出对应的剧本。您可以下载、修改剧本。修改后的剧本可以用于后续的集锦任务，产出更符合您期望的作品。
关于请求头与响应头，请参考公共请求头与响应头。
1. 获取剧本
任一项目中，对于已经完成分析的视频，您可以下载其剧本。
请求结构
Http
1GET /v2/highlight/projects/{projectId}/media/{mediaId}/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>响应参数
标准分析
| 参数名 | 类型 | 必要性 | 解释 |
|---|---|---|---|
| scriptUrl | string | 是 | 仅当项目为标准分析时为剧本下载链接，csv格式 |
| shots | Shot[] | 是 | 仅当深度分析时为分镜列表 |
Shot
| 参数名 | 类型 | 必要性 | 解释 |
|---|---|---|---|
| title | String | 是 | 分镜标题 |
| description | String | 是 | 分镜描述 |
| start | float | 是 | 开始时间（秒） |
| end | float | 是 | 结束时间（秒） |
| segments | Segment[] | 是 | 片段列表 |
Segment
| 参数名 | 类型 | 必要性 | 解释 |
|---|---|---|---|
| start | float | 是 | 开始时间（秒） |
| end | float | 是 | 结束时间（秒） |
| description | String | 是 | 片段描述 |
| subtitle | String | 是 | 对白字幕 |
| speaker | String | 是 | 说话人名字 |
请求示例
Http
1POST http://vod.bj.baidubce.com/v2/highlight/projects/pjt-xxxxxx/media/mda-xxxxxx/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>响应示例
标准分析
JSON
1{
2 "scriptUrl": "http://xxx.bcebos.com/vod-xxx/天龙八部.csv"
3}深度分析
JSON
1{
2 "shots": [
3 {
4 "title": "暧昧绮梦",
5 "description": "场景设定在一个充满暧昧氛围的办公室内，以紫色和粉色为主调，营造出一种迷幻、不真实的梦境感。镜头通过快速剪辑和虚焦效果，展现男主角陈飞的幻想世界，他正被一个性感强势的女老板所支配。这部分剧情主要塑造了陈飞懦弱、沉迷幻想的性格。",
6 "start": 0,
7 "end": 58.218,
8 "segments": [
9 {
10 "start": 0,
11 "end": 17.35,
12 "subtitle": "",
13 "speaker": "",
14 "description": "镜头从一双穿着黑色丝袜的美腿开始，充满了诱惑力。幻想中的女老板沈曼戴着眼镜，身穿白衬衫和松垮的领带，慵懒地坐在沙发上，翘起腿，用带有审视和挑逗的目光看着陈飞。画面中出现了“沈曼 聚宝斋老板”、“陈飞 聚宝斋伙计”的角色介绍。"
15 },
16 {
17 "start": 17.35,
18 "end": 18.35,
19 "subtitle": "陈飞",
20 "speaker": "沈曼",
21 "description": "沈曼用慵懒的语气叫着陈飞的名字。"
22 }
23 ]
24 },
25 {
26 "title": "现实的冰冷",
27 "description": "幻想被 abruptly 戳破，陈飞被未婚妻柳若墨和其助理高静当场抓包在上班时间睡觉。柳若墨对他不思进取的态度极为鄙夷，并提醒他今天是领证的日子。正当气氛尴尬时，柳若墨接到朋友出车祸的电话，她焦急的反应与对陈飞的冷漠形成鲜明对比，预示着两人关系的裂痕。",
28 "start": 58.218,
29 "end": 91.956,
30 "segments": [
31 {
32 "start": 58.218,
33 "end": 59.65,
34 "subtitle": "",
35 "speaker": "",
36 "description": "画面猛然切换，陈飞在摇椅上睡得正香，手里还抱着一个鸡毛掸子，口水直流。"
37 }
38 ]
39 }
40 ]
41}2. 导入剧本
如果您下载剧本后，在本地进行了一些修改，您可以将修改后的剧本导入到项目中，以覆盖默认剧本。后续发起集锦任务时，将以您修改后的剧本为准。
请求结构
Http
1PUT /v2/highlight/projects/{projectId}/media/{mediaId}/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>请求参数
| 参数名 | 类型 | 必要性 | 解释 |
|---|---|---|---|
| script | string | 是 | 仅当项目为标准分析时为剧本文本，注意必须是csv格式的文本字符串，且首行的表头要与下载时保持一致 |
| shots | Shot[] | 是 | 仅当项目为深度分析时为分镜列表 |
请求示例
标准分析
Http
1PUT http://vod.bj.baidubce.com/v2/highlight/projects/pjt-xxxxxx/media/mda-xxxxxx/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>
5
6{
7 "script": "\"序号\",\"角色名\",\"置信度\",\"时间段\",\"画面描述\",\"台词\"\n\"1\",\"\",\"\",\"00:00:00.350-00:00:01.250\",\"\",\"发大水了了\"\n\"2\",\"\",\"\",\"00:00:01.250-00:00:02.050\",\"\",\"快来人呐\"\n"
8}深度分析
Http
1PUT http://vod.bj.baidubce.com/v2/highlight/projects/pjt-xxxxxx/media/mda-xxxxxx/script HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>
5
6{
7 "shots": [
8 {
9 "title": "暧昧绮梦",
10 "description": "场景设定在一个充满暧昧氛围的办公室内，以紫色和粉色为主调，营造出一种迷幻、不真实的梦境感。镜头通过快速剪辑和虚焦效果，展现男主角陈飞的幻想世界，他正被一个性感强势的女老板所支配。这部分剧情主要塑造了陈飞懦弱、沉迷幻想的性格。",
11 "start": 0,
12 "end": 58.218,
13 "segments": [
14 {
15 "start": 0,
16 "end": 17.35,
17 "subtitle": "",
18 "speaker": "",
19 "description": "镜头从一双穿着黑色丝袜的美腿开始，充满了诱惑力。幻想中的女老板沈曼戴着眼镜，身穿白衬衫和松垮的领带，慵懒地坐在沙发上，翘起腿，用带有审视和挑逗的目光看着陈飞。画面中出现了“沈曼 聚宝斋老板”、“陈飞 聚宝斋伙计”的角色介绍。"
20 },
21 {
22 "start": 17.35,
23 "end": 18.35,
24 "subtitle": "陈飞",
25 "speaker": "沈曼",
26 "description": "沈曼用慵懒的语气叫着陈飞的名字。"
27 }
28 ]
29 },
30 {
31 "title": "现实的冰冷",
32 "description": "幻想被 abruptly 戳破，陈飞被未婚妻柳若墨和其助理高静当场抓包在上班时间睡觉。柳若墨对他不思进取的态度极为鄙夷，并提醒他今天是领证的日子。正当气氛尴尬时，柳若墨接到朋友出车祸的电话，她焦急的反应与对陈飞的冷漠形成鲜明对比，预示着两人关系的裂痕。",
33 "start": 58.218,
34 "end": 91.956,
35 "segments": [
36 {
37 "start": 58.218,
38 "end": 59.65,
39 "subtitle": "",
40 "speaker": "",
41 "description": "画面猛然切换，陈飞在摇椅上睡得正香，手里还抱着一个鸡毛掸子，口水直流。"
42 }
43 ]
44 }
45 ]
46}3. 重置剧本
如果您修改剧本后发觉不理想，想回退到系统默认剧本，您可以发起重置剧本的请求。
请求结构
Http
1POST /v2/highlight/projects/{projectId}/media/{mediaId}/reset HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>请求示例
Http
1POST http://vod.bj.baidubce.com/v2/highlight/projects/{projectId}/media/{mediaId}/reset HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>