字幕擦除

更新时间：2025-11-03

字幕擦除是媒资维度的，一次仅能对一个媒资进行擦除。目前字幕擦除需要白名单权限，如果提示“权限不足”或者任务无法成功，请联系我们。

1. 创建字幕擦除任务

请求结构

Http

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

请求参数

字段名	类型	必要性	参数位置	详细说明
mediaId	string	是	RequestBody参数	媒资 ID
subtitleType	string	是	RequestBody参数	字幕擦除类型 dialog：对白字幕擦除 global：全局字幕擦除 manual：自定义区域字幕擦除
desubtitleParams	object[]		RequestBody参数	字幕擦除参数
[+] startTimeInMillisecond	int		RequestBody参数	开始字幕擦除的起始时间，默认为 0ms，单位ms
[+] endTimeInMillisecond	int		RequestBody参数	完成字幕擦除的结束时间，默认为媒资时长，单位ms
[+] areaList	object[]		RequestBody参数	字幕擦除的自定义区域参数，subtitleType=manual必填
[+][+] x	float		RequestBody参数	自定义区域框最左侧边界距离视频画面左边界距离，单位px
[+][+] y	float		RequestBody参数	自定义区域框最上侧边界距离视频画面上边界距离，单位px
[+][+] width	float		RequestBody参数	自定义区域框宽度，单位px
[+][+] height	float		RequestBody参数	自定义区域框高度，单位px

响应参数

参数	类型	必要性	详细说明
taskId	string	是	任务 ID

请求示例

Http

1POST https://vod.bj.baidubce.com/v2/desubtitle 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    "mediaId": "mda-fjjs54phsyf0xkt9",
9    "subtitleType": "manual",
10    "desubtitleParams": [
11        {
12            "areaList": [
13                {
14                    "x": 60,
15                    "y": 500,
16                    "height": 100,
17                    "width": 100
18                },
19                {
20                    "x": 60,
21                    "y": 100,
22                    "height": 100,
23                    "width": 100
24                }
25            ],
26            "endTimeInMillisecond": 0,
27            "startTimeInMillisecond": 1000
28        }
29    ]
30}

响应示例

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

2. 查询字幕擦除任务

请求结构

Http

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

请求参数

字段名	类型	参数位置	详细说明
marker	string	Query参数	marker 分页游标
maxSize	int	Query参数	分页大小，默认为10，参数范围[1,100]
status	String	Query参数	任务状态筛选
taskId	String	Query参数	任务 ID 筛选
mediaId	String	Query参数	媒资 ID 筛选
beginTime	String	Query参数	筛选创建时间的时间区间，开始时间
endTime	String	Query参数	筛选创建时间的时间区间，结束时间
sortBy	String	Query参数	排序方式 CREATE_TIME：创建时间升序 -CREATE_TIME：创建时间降序（默认值）

响应参数

字段名	类型	必要性	详细说明
data	object[]	是	任务数据列表
[+] mediaId	string	是	媒资 ID
[+] taskId	string	是	任务 ID
[+] targetUrl	string	是	输出视频地址
[+] coverUrl	string	是	输出视频封面地址
[+] name	string	是	文件名或任务名
[+] status	string	是	任务状态 READY：处理中 RUNNING：处理中 FINISHED：已完成
[+] subtitleType	string	是	字幕擦除类型 dialog：对白字幕擦除 global：全局字幕擦除 manual：自定义区域字幕擦除
[+] durationInSeconds	number	是	视频时长，单位s
[+] storageClass	string	是	存储类型 STANDARD：标准存储 ARCHIVE：归档存储
[+] banStatus	string	是	审核状态 NORMAL：正常 BAN：封禁
[+] createTime	string	是	创建时间（UTC 时间，ISO 8601 格式）
[+] updateTime	string	是	更新时间（UTC 时间，ISO 8601 格式）
marker	string	是	当前页最后一个任务的标识（用于下一次分页请求的起点）
isTruncated	boolean	是	是否还有下一页 true：还有数据 false：已到末尾

请求示例

Http

1GET https://vod.bj.baidubce.com/v2/desubtitle/list?taskId=tsk-fkctk181rrgr31qw 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-fjjs54phsyf0xkt9",
      "taskId": "tsk-fkctk181rrgr31qw",
      "targetUrl": "http://vod-em5xuw1affk1r014.bj-bos-sandbox.baidu-int.com/v1/mda-fjjs54phsyf0xkt9/_output/transfhfx7i6zp8suq1gxyn3s/mda-fjjs54phsyf0xkt9.mp4?authorization=bce-auth-v1%2FALTAKcfr7rzaK44AsMUcaT2dVH%2F2025-11-03T09%3A23%3A32Z%2F3600%2F%2Fbd2711e3064c41a9ec1689122cd9b7ed0af17b7ee47645895f18c845e638ba22",
      "coverUrl": "http://vod-em5xuw1affk1r014.bj-bos-sandbox.baidu-int.com/v1/mda-fjjs54phsyf0xkt9/_output/thumbem5xhtczvya3yu1sx63u/mda-fjjs54phsyf0xkt900000000.jpg?authorization=bce-auth-v1%2FALTAKcfr7rzaK44AsMUcaT2dVH%2F2025-11-03T09%3A23%3A32Z%2F3600%2F%2F01cc06d6086ce560801919c7f5adea4210a66b1d24bdf5275d2ca81328eab530",
      "name": "-5-2025-09-12T19_21_11Z",
      "status": "FINISHED",
      "subtitleType": "manual",
      "durationInSeconds": 5,
      "storageClass": "STANDARD",
      "banStatus": "NORMAL",
      "createTime": "2025-11-03T09:06:28Z",
      "updateTime": "2025-11-03T09:11:55Z"
    }
  ],
  "marker": "tsk-fkctk181rrgr31qw",
  "isTruncated": false
}
            

3. 删除字幕擦除任务

请求结构

Http

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

请求参数

字段名	类型	必要性	参数位置	详细说明
taskIds	string[]	是	RequestBody参数	任务 ID 列表

请求示例

Http

1POST https://vod.bj.baidubce.com/v2/desubtitle/batchDelete 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    "taskIds": [
9        "tsk-fkctk181rrgr31qw"
10    ]
11}

API在线调试

播放器SDK

百度智能云

智能点播平台 VOD

智能点播平台 VOD

字幕擦除

1. 创建字幕擦除任务

请求结构

请求参数

响应参数

请求示例

响应示例

2. 查询字幕擦除任务

请求结构

请求参数

响应参数

请求示例

响应示例

3. 删除字幕擦除任务

请求结构

请求参数

请求示例