摘要任务
更新时间：2026-02-02
在智能集锦项目中，需要媒资完成视频理解，才能调用摘要生成，且每个媒资首次调用摘要生成不计费。
1. 创建摘要任务
请求结构
Http
1POST /v2/highlight/understand/summary HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>请求参数
| 参数 | 类型 | 是否必填 | 参数位置 | 描述 |
|---|---|---|---|---|
| projectId | string | 是 | RequestBody参数 | 项目ID |
| mediaIdList | array | 是 | RequestBody参数 | 媒资ID列表 |
响应参数
无
请求示例
Http
1POST https://vod.bj.baidubce.com/v2/highlight/understand/summary 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 "projectId": "pjt-fjvtg03paqrfvgcq",
8 "mediaIdList": ["mda-abc123", "mda-def456"]
9}2. 查询摘要
请求结构
Http
1GET /v2/highlight/understand/summary HTTP/1.1
2content-type: application/json
3host: vod.bj.baidubce.com
4authorization: <bce-authorization-string>请求参数
| 参数 | 类型 | 是否必填 | 参数位置 | 描述 |
|---|---|---|---|---|
| projectId | string | 是 | Query参数 | 项目ID |
| mediaId | string | 是 | Query参数 | 媒资ID |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| result | string | 摘要内容 |
请求示例
Http
1GET https://vod.bj.baidubce.com/v2/highlight/understand/summary?projectId=pjt-fjvtg03paqrfvgcq&mediaId=mda-abc123 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
1{
2 "这是一段视频的摘要内容，包含视频的主要信息和关键点描述。"
3}3. 查询摘要任务状态
参考项目管理中查询项目中的视频列表