项目管理

更新时间：2025-08-22

集锦“项目”是智能集锦产品的基本单元。创建一个项目，可用于存放一部剧集（若干个视频）。每个视频被添加到项目中后，会自动触发视频分析任务，即利用AI模型解析视频中的画面描述、字幕、角色等信息。每个视频分析完成后，会自动将其中出现的角色归入到项目角色库，选中若干个视频，可以发起集锦任务。

注意事项：

AI识别的角色信息无法保证完全正确，正式生产作品之前，建议您在智能集锦项目中核对并修正角色信息。

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

1. 创建项目

在智能集锦服务中，创建一个项目是一切的开始。创建项目时，可以指定项目名称、项目类型、项目描述等信息，也可以顺便添加若干个视频。

请求结构

Http

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

请求参数

字段名	类型	必要性	详细说明
name	string	是	项目名称，utf8字数范围[1,100]；不允许与已有项目重名。
description	string		描述信息，utf8字数范围[0,255]
type	string		项目类型： - `ShortSeries`，(默认)短剧类型，每个媒资的时长不能超过20分钟； - `TVSeries`，电视剧类型，每个媒资的时长必须介于10~80分钟； - `Moive` 电影类型，每个媒资时长必须要大于60分钟。
mediaList	object[]		要添加到项目中的媒资列表，请提前在媒资库中上传视频（API参考：拉取上传、HTTP上传）
[+] mediaId	string	是	媒资id
[+] clips	object[]		指定有效时间段。不填则默认为整个视频。
[+][+] start	float	是	起始时间，单位为秒
[+][+] end	float	是	结束时间，单位为秒

响应参数

参数	类型	必要性	详细说明
projectId	string	是	项目 id
mediaList	object[]		添加成功的媒资列表
[+] mediaId	string	是	媒资id
[+] taskId	string	是	任务id，可在VOD任务中心看到，也可通过API查询任务详情

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/projects 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    "name": "demo",
9    "type": "TVSeries",
10    "description": "这是我的第一个集锦项目",
11    "mediaList": [
12        {
13            "mediaId": "mda-123456",
14            "clips": [
15                {
16                    "start": 10.500,
17                    "end": 68.760
18                }
19            ]
20        }
21    ]
22}

响应示例

                JSON
                
            

                {
    "projectId": "prj-123456",
    "mediaList": [
        {
            "mediaId": "mda-123456",
            "taskId": "tsk-123456"
        }
    ]
}
            

2. 向项目中添加视频

如果您在创建项目时，没有将视频全部添加到项目，可以调用此接口继续向项目中添加视频。这里提供两种方式，任选其一即可。

【方式一】URL方式添加视频

如果视频是URL形式，可使用此方式完成上传。其原理是在拉取上传接口的基础上拓展除了highlightParams参数。

请求结构

Http

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

请求参数

参数	类型	必要性	解释
url	string	是	拉取文件url，长度不超过1024，支持的文件封装格式（url末尾的文件名后缀）：视频包括：mp4、flv、mov、3gp、avi、mpg、asf、wmv、mkv、ts、webm、mxf 音频包括：mp3、m4a、flac、ogg、wav、ra、aac、amr 图片包括：jpg、jpeg、png、gif、bmp、webp、svg
name	string		媒资名称，如果不指定name，将会从url中提取文件名作为生成的媒资名称
coverUrl	string		封面链接，不填则自动生成。长度不超过1024，支持的文件封装格式（url末尾的文件名后缀）：jpg、jpeg、png、gif、bmp、webp
categoryId	string		媒资类别id，可在分类管理中进行管理
highlightParams	object	是	当前视频上传完成后，添加到指定的集锦项目中
[+] projectId	string	是	集锦项目id
[+] clips	list		当前视频的有效时间区间。可将片头、片尾、广告等时间段剔除，保留下的有效区间填入该列表，减少片尾、广告等无用内容对视频理解的负面影响
[+][+] start	float	是	当前有效片段的起始时间，单位秒
[+][+] end	float	是	当前有效片段的结束时间，单位秒

响应参数

参数	类型	解释
taskId	string	当前上传任务id（注意并非视频解析任务id），可在VOD任务中心看到，也可通过API查询任务详情

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/medias/fetch 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    "url": "https://vod-em5xdv8h7e8az2wt.bj-bos-sandbox.baidu-int.com/v1/mda-famw36en0xyapini/_src/mda-famw36en0xyapini.mp4",
9    "highlightParams": {
10        "projectId": "pjt-fbtwdtn1tfead7cb",
11        "clips": [
12            {
13                "start": 93.2,
14                "end": 2423.5
15            }
16        ]
17    },
18    "name": "风月债01"
19}

响应示例

                JSON
                
                {
    "taskId": "tsk-123456"
}

【方式二】添加媒资

先参考HTTP上传接口将本地视频上传到VOD媒资库，并得到媒资id（例如mda-123456）。然后调用下面的接口，可将视频添加到项目中。

请求结构

Http

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

请求参数

参数	类型	必要性	描述
mediaList	object[]	是	媒资列表
[+] mediaId	string	是
[+] clips	list	是	当前视频的有效时间区间。强烈建议将片头、片尾、广告等时间段剔除，保留下的有效区间填入该列表，否则片尾、广告等无用内容对视频理解的负面影响较大。
[+][+] start	float	是	当前有效片段的起始时间，单位秒
[+][+] end	float	是	当前有效片段的结束时间，单位秒

响应参数

字段	类型	必要性	解释
mediaList	object[]	是	添加成功的媒资列表
[+] mediaId	string	是	媒资id
[+] taskId	string	是	任务id，可在VOD任务中心看到，也可通过API查询任务详情

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/projects/pjt-fbtwdtn1tfead7cb/media 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    "mediaList": [
9        {
10            "mediaId": "mda-123456",
11            "clips": [
12                {
13                    "start": 93.2,
14                    "end": 2423.5
15                }
16            ]
17        }
18    ]
19}

响应示例

                JSON
                
            

                {
    "mediaList": [
        {
            "mediaId": "mda-123456",
            "taskId": "tsk-123456"
        }
    ]
}
            

3. 查询项目

请求结构

Http

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

响应参数

字段	类型	必要性	解释
projectId	string	是	项目id
name	string	是	项目名称，一般为剧名
description	string	是	项目描述
type	string	是	项目类型，取值有`ShortSeries`,`TVSeries`,`Movie`
createTime	string	是	创建时间

响应示例

                JSON
                
            

                {
    "projectId": "pjt-fd2kxzwei9gta3vw",
    "name": "天龙八部",
    "description": "",
    "type": "ShortSeries",
    "createTime": "2025-04-27T02:38:36Z"
}
            

4. 查询项目中的视频列表

请求结构

Http

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

查询参数

参数	类型	必要性	描述
status	string		筛选视频理解状态,取值：`PENDING`,`RUNNING`,`SUCCESS`,`FAILED`
summaryStatus	string		筛选摘要生成状态,取值：`PENDING`,`RUNNING`,`SUCCESS`,`FAILED`

响应参数

字段	类型	必要性	解释
data	MediaBasicInfo[]	是	视频列表。每个元素代表一条视频信息，除MediaBasicInfo所有字段外，额外提供以下字段
[+] status	string	是	视频理解状态,取值：`PENDING`,`RUNNING`,`SUCCESS`,`FAILED`
[+] summaryStatus	string	是	摘要生成状态，取值：`PENDING`,`RUNNING`,`SUCCESS`,`FAILED`
[+] errMsg	string		当status=FAILED时，给出错误信息
[+] summarrErrMsg	string		当summaryStatus=FAILED时，给出错误信息
[+] updateTime	string	是	最近更新时间
[+] scriptUpdateTime	string		当前视频对应的剧本的最近更新时间

请求示例

Http

1GET http://vod.bj.baidubce.com/v2/highlight/projects/pjt-xxxxxx/medias?status=SUCCESS 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

响应示例

                JSON
                
            

                {
    "data": [
        {
            "mediaId": "mda-1234569abcdefghi",
            "name": "天龙八部第1集",
            "description": "",
            "status": "SUCCESS",
            "summaryStatus": "SUCCESS",
            "createTime": "2025-04-27T02:38:36Z",
            "updateTime": "2025-04-27T02:38:36Z",
            "scriptUpdateTime": "2025-04-27T02:38:36Z",
            "mediaType": "video",
            "banStatus": "NORMAL",
            "createTime": "2025-04-27T02:44:30Z",
            "categoryId": "system",
            "source": {
                "sourceKey": "mda-fbsx38gyvnr4a03p/_src/mda-fbsx38gyvnr4a03p/fbsxmxmsgicthmvcq0y2.mp4",
                "coverKey": "mda-fbsx38gyvnr4a03p/_output/thumbem5xhtczvya3yu1sx63u/mda-fbsx38gyvnr4a03p00000000.jpg",
                "sourceType": "UPLOAD",
                "sourceUrl": "https://vod-em5xuw1affk1r014.bj-bos-sandbox.baidu-int.com/v1/mda-fbsx38gyvnr4a03p/_src/mda-fbsx38gyvnr4a03p/fbsxmxmsgicthmvcq0y2.mp4?authorization=xxxxxx",
                "coverUrl": "https://vod-em5xuw1affk1r014.bj-bos-sandbox.baidu-int.com/v1/mda-fbsx38gyvnr4a03p/_output/thumbem5xhtczvya3yu1sx63u/mda-fbsx38gyvnr4a03p00000000.jpg?authorization=xxxxxx"
            },
            "sourceMetadata": {
                "fileSizeInByte": 28929675,
                "type": "video",
                "container": "mov,mp4,m4a,3gp,3g2,mj2",
                "durationInSecond": 171,
                "durationInMillisecond": 171270,
                "video": {
                    "codec": "h264",
                    "heightInPixel": 1280,
                    "widthInPixel": 720,
                    "bitRateInBps": 1218009,
                    "frameRate": 30.0,
                    "dar": "9:16"
                },
                "audio": {
                    "codec": "aac",
                    "channels": 2,
                    "sampleRateInHz": 44100,
                    "bitRateInBps": 129447
                },
                "etag": "-30842e14e820315d00bc99eb99e24fe5"
            }
        }
    ]
}
            

5. 删除项目

如无特殊需要，不建议删除项目。如坚持要删除，请注意：

项目删除后，不支持恢复，请谨慎操作；
项目删除时，已进入处理中的视频理解任务、集锦任务等，仍将继续执行直到完成并计费；

请求结构

Http

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

请求参数

字段	类型	必要性	解释
projectIdList	string[]	是	要删除的项目id列表
[+] projectId	string	是	项目id

请求示例

Http

1POST http://vod.bj.baidubce.com/v2/highlight/projects/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/1faf5b1da2420b31a1d9dae46387524db0b0567e3f7dcfc24516ed91ab23fdee
6
7{
8    "projectIdList": [
9        "pjt-fd2kxzwei9gta3vw"
10    ]
11}

剧本管理

集锦任务

智能点播平台 VOD

智能点播平台 VOD

项目管理

1. 创建项目

请求结构

请求参数

响应参数

请求示例

响应示例

2. 向项目中添加视频

【方式一】URL方式添加视频

请求结构

请求参数

响应参数

请求示例

响应示例

【方式二】添加媒资

请求结构

请求参数

响应参数

请求示例

响应示例

3. 查询项目

请求结构

响应参数

响应示例

4. 查询项目中的视频列表

请求结构

查询参数

响应参数

请求示例

响应示例

5. 删除项目

请求结构

请求参数

请求示例