视频数字水印提取接口
更新时间:2024-07-03
创建数字水印提取任务
接口描述
用户通过该接口提取视频中的数字水印。
注:务必选择与嵌入数字水印任务相同的算法版本,否则无法正确提取水印内容。算法说明可见视频数字水印嵌入接口。
请求结构
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 ~ 2 | 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: 2023-11-08T21: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/2023-11-08T21: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: 2023-11-08T21: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/2023-11-08T21: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: 2023-11-08T21: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/2023-11-08T21: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": "2023-11-09T12:26:17Z",
13 "startTime": "2023-11-09T12:26:18Z",
14 "endTime": "2023-11-09T12: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": "2023-11-09T12:26:17Z",
14 "startTime": "2023-11-09T12:26:18Z",
15 "endTime": "2023-11-09T12: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}