视频数字水印提取接口
更新时间：2025-08-04
创建数字水印提取任务
接口描述
用户通过该接口提取视频中的数字水印。
注：务必选择与嵌入数字水印任务相同的算法版本，否则无法正确提取水印内容。算法说明可见视频数字水印嵌入接口。
请求结构
Http
1POST /v{version}/job/dwmdetect HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4connection: keep-alive
5accept: */*
6host: media.bj.baidubce.com
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
除公共头域外，无其它特殊头域。
请求参数
无
请求体
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| pipelineName | String | 必选 | 任务所属的队列名称 | - | - |
| source | Object | 必选 | 输入视频信息集合 | - | - |
| +bucket | String | 可选 | 输入视频的BOS Bucket（用户必须有该bucket的读权限） | - | 队列中指定的输入bucket |
| +key | String | 必选 | 输入视频的BOS Key | - | - |
| target | String | 可选 | 输出图片水印信息(仅提取图片水印时可配置) | - | - |
| +bucket | String | 可选 | 输出图片的BOS Bucket（用户必须有该bucket的写权限） | - | 队列中指定的输出bucket |
| +keyPrefix | String | 可选 | 输出图片的BOS Key前缀，输出的完整key为"前缀_dwm_extract.png" | - | 视频文件名 |
| digitalWmAlgVersion | String | 可选 | 算法版本号 | 0 ~ 3 | 0 |
| digitalWmType | String | 必选 | 提取水印类型，图片或文字 | "image", "text" | - |
| digitalWmSecretKeyId | String | 可选 | 数字水印密钥ID，需要与嵌入时密钥一致 | - | - |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| jobId | String | 系统生成的任务的唯一标识 |
请求示例
提取图片水印
Http
1POST /v3/job/dwmdetect HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2025-08-04T21:21:21Z
4host: media.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
8content-type: application/json
9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
10{
11 "pipelineName": "high_priority_pipe",
12 "source": {
13 "bucket": "input",
14 "key": "test.mp4"
15 },
16 "target": {
17 "bucket": "output",
18 "keyPrefix": "test"
19 }，
20 "digitalWmAlgVersion": 0,
21 "digitalWmType": "image",
22 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
23}提取文字水印
Http
1POST /v3/job/dwmdetect HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2025-08-04T21:21:21Z
4host: media.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
8content-type: application/json
9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
10{
11 "pipelineName": "high_priority_pipe",
12 "source": {
13 "bucket": "input",
14 "key": "test.mp4"
15 },
16 "digitalWmAlgVersion": 2,
17 "digitalWmType": "text",
18 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
19}响应示例
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
4Cache-Control: no-cache
5Server: BWS
6Date: Wed, 08 Nov 2023 07:36:48 GMT
7Content-Type: application/json;charset=UTF-8
8{
9 "jobId": "job-pk7n403picat90kr"
10}查询数字水印提取任务
接口描述
用户通过该接口查询视频数字水印提取历史任务信息。
请求结构
Http
1GET /v{version}/job/dwmdetect/{jobId} HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4connection: keep-alive
5accept: */*
6host: media.bj.baidubce.com
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| jobId | String | 必选 | 系统生成的任务的唯一标识 | - | - |
请求体
无
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| jobId | String | 系统生成的任务的唯一标识 |
| pipelineName | String | 任务所属的队列名称 |
| jobStatus | String | 任务状态(SUCCESS, FAILED) |
| createTime | String | 任务创建时间 |
| startTime | String | 任务开始处理时间 |
| endTime | String | 任务结束时间 |
| error | Object | 错误信息，任务失败时存在 |
| +code | String | 错误码 |
| +message | String | 错误信息 |
| source | Object | 输入视频信息集合 |
| +bucket | String | 输入视频的BOS Bucket |
| +key | String | 输入视频的BOS Key |
| target | Object | 输出提取图片水印信息(仅提取图片水印时有该字段) |
| +bucket | String | 输出图片的BOS Bucket（用户必须有该bucket的写权限） |
| +keyPrefix | String | 输出图片的BOS Key前缀 |
| +keys | Array<String> | 提取出的水印图片的BOS Key列表，可能有多个 |
| digitalWmAlgVersion | Integer | 算法版本号 |
| digitalWmType | String | 提取水印类型 |
| digitalWmSecretKeyId | String | 数字水印密钥ID |
| detectedTexts | Array<String> | 提取的水印文字 |
请求示例
Http
1GET /v3/digitalwatermark/dwm-pa4mz6n8i7sefz0p HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2025-08-04T21:21:21Z
4host: media.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
8content-type: application/json
9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2025-08-04T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9响应示例
提取图片水印
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
4Cache-Control: no-cache
5Server: BWS
6Date: Wed, 08 Nov 2023 07:36:48 GMT
7Content-Type: application/json;charset=UTF-8
8{
9 "jobId": "job-pk8uyexbbv7ebji9",
10 "pipelineName": "high_priority_pipe",
11 "jobStatus": "SUCCESS",
12 "createTime": "2025-08-04T12:26:17Z",
13 "startTime": "2025-08-04T12:26:18Z",
14 "endTime": "2025-08-04T12:26:27Z",
15 "source": {
16 "bucket": "input",
17 "key": "test.mp4"
18 },
19 "target": {
20 "bucket": "output",
21 "keyPrefix": "test",
22 "keys": [
23 "test_dwm_extract.png"
24 ]
25 },
26 "digitalWmAlgVersion": 0,
27 "digitalWmType": "image",
28 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8"
29}提取文字水印
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
4Cache-Control: no-cache
5Server: BWS
6Date: Wed, 08 Nov 2023 07:36:48 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10 "jobId": "job-pk8uyexbbv7ebji9",
11 "pipelineName": "high_priority_pipe",
12 "jobStatus": "SUCCESS",
13 "createTime": "2025-08-04T12:26:17Z",
14 "startTime": "2025-08-04T12:26:18Z",
15 "endTime": "2025-08-04T12:26:27Z",
16 "source": {
17 "bucket": "input",
18 "key": "test.mp4"
19 },
20 "digitalWmAlgVersion": 2,
21 "digitalWmType": "text",
22 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
23 "detectedTexts": [
24 "baidu"
25 ]
26}