视频数字水印密钥模板接口
更新时间：2025-08-21
创建数字水印密钥模板
接口描述
用户通过该接口创建数字水印密钥模板。密钥模板可配置在转码模板或转码任务中，在嵌入转码任务中用于对数字水印内容加密，提升安全性。
请求结构
Http
1POST /v{version}/digitalwatermark/secretkey 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
无
请求体
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| digitalWmSecretKeyId | String | 可选 | 数字水印密钥ID | 字符串长度<22 | 如果不设置, 会自动生成一个ID, 格式为: key-16位随机id |
| description | String | 可选 | 自定义描述信息 | 字符串长度<128 | 空字符串 |
| secretKey | String | 必选 | 密钥内容 | 字符串长度6~16, 仅限英文、数字及部分特殊字符 | - |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| digitalWmSecretKeyId | String | 数字水印密钥ID |
请求示例
Http
1POST /v3/digitalwatermark/secretkey 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 "description": "test key",
12 "secretKey": "password",
13}响应示例
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 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8"
10}查询指定数字水印密钥模板
接口描述
用户通过该接口查询已创建的数字水印密钥模板。
请求结构
Http
1GET /v{version}/digitalwatermark/secretkey/{digitalWmSecretKeyId} 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| digitalWmSecretKeyId | String | 必选 | 数字水印密钥ID | - | - |
请求体
无
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| digitalWmSecretKeyId | String | 数字水印密钥ID |
| description | String | 自定义描述信息 |
| createTime | String | 创建时间 |
| state | String | 模板状态，ACTIVE/INACTIVE |
| secretKey | String | 密钥内容 |
请求示例
Http
1GET /v3/digitalwatermark/secretkey/key-pi0nwwuw45zx0ya8 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 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
10 "description": "",
11 "createTime": "2023-11-08T07:36:48Z",
12 "state": "ACTIVE",
13 "secretKey": "password"
14}查询所有数字水印密钥模板
接口描述
用户通过该接口查询所有已创建数字水印密钥模板构成的列表。
请求结构
Http
1GET /v{version}/digitalwatermark/secretkey/ 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
无
请求体
无
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| secretKeys | Array |
数字水印密钥模板列表 |
DigitalWatermarkSecretKey内部字段定义见查询指定数字水印密钥模板的响应参数。
请求示例
Http
1GET /v3/digitalwatermark/ 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 "secretKeys": [
10 {
11 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
12 "description": "",
13 "createTime": "2023-11-08T07:36:48Z",
14 "state": "ACTIVE",
15 "secretKey": "password"
16 },
17 {
18 "digitalWmSecretKeyId": "key-pi0nz8cxzdfzy7b1",
19 "description": "",
20 "createTime": "2023-11-08T07:36:48Z",
21 "state": "ACTIVE",
22 "secretKey": "password2"
23 }
24 ]
25}删除指定数字水印密钥模板
接口描述
用户通过该接口删除已创建的数字水印密钥模板。
请求结构
Http
1DELETE /v{version}/digitalwatermark/secretkey/{digitalWmSecretKeyId} 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
无
请求体
无
响应头域
除公共头域外，无其它特殊头域。
响应参数
无
请求示例
Http
1DELETE /v3/digitalwatermark/secretkey/key-pi0nwwuw45zx0ya8 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
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Cache-Control: no-cache其他说明
暂不支持修改已有模板内容或删除后重新创建同ID模板。