视频数字水印嵌入接口
更新时间：2025-08-04
功能说明
视频数字水印嵌入功能是视频转码任务的子功能，需要通过创建视频转码任务使用。本文档主要介绍数字水印相关参数及使用示例，请先参考文档视频转码模板接口和视频转码任务接口了解转码功能使用。
在转码中使用数字水印嵌入功能，主要有两种配置方法，适用于两种不同的应用场景，可根据自身需求选择：
- (推荐) 在转码任务中配置数字水印。在转码任务中指定数字水印内容、算法参数、密钥等，可搭配常规转码模板(转码模板无需配置数字水印)使用，无需专门创建配置了数字水印的转码模板。
- 在转码模板中配置数字水印。若应用场景的数字水印内容及转码配置相对固定，也可预先创建数字水印模板，然后在转码模板中配置数字水印模板、密钥、算法参数，无需在任务中再次配置。
注：若同时在转码模板和转码任务中配置了数字水印参数，则转码任务参数优先生效。例如，在转码模板中配置了数字水印模板，同时在转码任务中配置了数字水印文字内容，则实际嵌入水印为任务中的文字。
算法版本说明
当前视频数字水印功能提供4种算法，可通过digitalWmAlgVersion参数选择。各算法的主要特点如下：
| 算法版本号 | 支持的水印类型 | 视频要求 | 水印容量 | 主要特点 | 适用场景 |
|---|---|---|---|---|---|
| 0 | 图片、文字(仅支持ASCII字符) | 嵌入文字时, 宽×高>=327680 | 不超过40字符 | 早期版本，抗攻击能力较弱，不推荐使用 | 不推荐使用 |
| 1 | 文字 | 宽,高>=320(嵌入字符较多时最低分辨率可能增加) | 不超过100字节(中文算作3字节) | 可一定程度抵抗裁剪、遮挡、剪辑、拼接、转码压缩等攻击，对时域攻击抵抗能力较好 | 视频时长短、分辨率较高的场景 |
| 2 | 文字 | 时长>=30s，分辨率不限 | 不超过100字符(中英文不限) | 抗攻击能力强，可一定程度抵抗缩放、遮挡、剪辑、拼接、转码压缩等攻击(长视频效果更佳) | 视频时长可满足最低要求的场景 |
| 3 | 文字 | 时长>=5s，分辨率不限 | 不超过100字符(中英文不限) | 抗攻击能力与版本2接近，但可用于更短的视频 | 视频时长较短的场景，例如AI生成视频、短视频剪辑等 |
算法选择建议
在视频可满足要求的前提下，建议优先选择v2/v3，其次考虑v1。v0算法为早期版本，不推荐使用。
在转码任务中配置数字水印
接口描述
在转码任务中添加数字水印及密钥以在转码时嵌入数字水印。
请求体
注：只列出与视频数字水印功能相关的字段。文字与图片水印必须二选一，不可同时配置。
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| target | Object | 必选 | 输出信息的集合 | - | - |
| +digitalWmTextContent | String | 可选 | 需嵌入的文字内容 | 字符数<=100, 支持中英文及标点符号(如需嵌入中文请选择v1及以上版本算法) | - |
| +digitalWmImageBucket | String | 可选 | (仅算法0支持图片)需嵌入图片的Bos Bucket | - | - |
| +digitalWmImageKey | String | 可选 | (仅算法0支持图片)需嵌入图片的Bos Key | - | - |
| +digitalWmSecretKeyId | String | 可选 | 数字水印密钥模板ID，密钥用于对水印加密嵌入，提取水印需提供正确密钥 | 需从用户已创建的数字水印密钥模板选择，生效优先级高于转码模板中的密钥 | - |
| +digitalWmAlgVersion | Integer | 可选 | 算法版本号，请参考算法版本说明一节 | 0 ~ 3 | 0 |
| +digitalWmStrength | Float | 可选 | (算法版本>=1有效)数字水印嵌入强度，对同一算法，强度越高则抗攻击能力越强，隐蔽性越差 | 0 ~ 1 | 0.5 |
请求示例
Http
1POST /v3/job 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 "clips": [
14 {
15 "bucket": "input",
16 "sourceKey": "source.mp4"
17 }
18 ]
19 },
20 "target": {
21 "bucket": "output",
22 "key": "source_embed.mp4",
23 "presetName": "x265_preset",
24 "digitalWmTextContent": "baidu",
25 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
26 "digitalWmAlgVersion": 2,
27 "digitalWmStrength": 0.5
28 },
29}在转码模板中配置数字水印
接口描述
在转码模板中添加数字水印模板及密钥以在转码时嵌入数字水印。转码模板的创建、修改等功能请参考视频转码模板接口。
请求体
注：只列出与视频数字水印功能相关的字段。
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| digitalWmId | String | 可选 | 需嵌入的数字水印模板ID | 需从用户已创建的数字水印模板选择 | - |
| digitalWmSecretKeyId | String | 可选 | 数字水印密钥模板ID，密钥用于对水印加密嵌入，提取水印需提供正确密钥 | 需从用户已创建的数字水印密钥模板选择，生效优先级高于转码模板中的密钥 | - |
| digitalWmAlgVersion | Integer | 可选 | 算法版本号，请参考算法版本说明一节 | 0 ~ 3 | 0 |
| digitalWmStrength | Double | 可选 | (算法版本>=1有效)数字水印嵌入强度，对同一算法，强度越高则抗攻击能力越强，隐蔽性越差 | 0 ~ 1 | 0.5 |
请求示例
Http
1POST /v3/preset 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 "presetName": "embed_preset",
12 "description": "embed digital watermark",
13 "container": "mp4",
14 "clip": {
15 "startTimeInSecond": 0
16 },
17 "audio": {
18 "bitRateInBps": 256000
19 },
20 "video": {
21 "codec": "h264",
22 "codecOptions": {
23 "profile": "baseline"
24 },
25 "bitRateInBps": 1024000,
26 "maxFrameRate": 30,
27 "maxWidthInPixel": 4096,
28 "maxHeightInPixel": 3072,
29 "sizingPolicy": "keep",
30 "playbackSpeed": 1.5
31 },
32 "digitalWmId": "dwm-pa4mz6n8i7sefz0p",
33 "digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
34 "digitalWmAlgVersion": 2,
35 "digitalWmStrength": 0.6,
36}查询视频数字水印嵌入任务
视频数字水印嵌入任务的查询接口同视频转码任务，请参考视频转码任务接口使用。