视频数字水印嵌入接口
更新时间:2024-02-22
说明
视频数字水印嵌入功能需通过发起视频转码任务使用。本文档主要介绍本功能相关参数及使用示例,详细接口请参考视频转码模板接口和视频转码任务接口。
在转码模板中配置数字水印
接口描述
在转码模板中添加数字水印模板及密钥以在转码时嵌入数字水印。转码模板的创建、修改等功能请参考视频转码模板接口。
请求体
注:只列出与视频数字水印功能相关的字段。
字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
---|---|---|---|---|---|
digitalWmId | String | 可选 | 需要嵌入到输出视频中的数字水印模板ID | 需从用户已创建的数字水印模板选择 | - |
digitalWmSecretKeyId | String | 可选 | 数字水印密钥模板ID | 需从用户已创建的数字水印密钥模板选择 | - |
请求示例
POST /v3/preset HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2023-11-08T21:21:21Z
host: media.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2023-11-08T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"presetName": "embed_preset",
"description": "embed digital watermark",
"container": "mp4",
"clip": {
"startTimeInSecond": 0
},
"audio": {
"bitRateInBps": 256000
},
"video": {
"codec": "h264",
"codecOptions": {
"profile": "baseline"
},
"bitRateInBps": 1024000,
"maxFrameRate": 30,
"maxWidthInPixel": 4096,
"maxHeightInPixel": 3072,
"sizingPolicy": "keep",
"playbackSpeed": 1.5
},
"digitalWmId": "dwm-pa4mz6n8i7sefz0p",
"digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8"
}
创建视频数字水印嵌入任务
接口描述
用户可以通过创建视频转码任务以使用视频数字水印嵌入功能,只需要在任务中使用已配置数字水印的转码模板即可。此外可以在转码任务中配置数字水印密钥及文字内容,以覆盖转码模板中的配置。转码任务的创建等功能请参考视频转码任务接口。
请求体
注:只列出与视频数字水印功能相关的字段。
字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
---|---|---|---|---|---|
target | Object | 必选 | 输出信息的集合 | - | - |
+presetName | String | 必选 | 转码模板名称,需选择配置了数字水印模板的转码模板 | - | - |
+digitalWmTextContent | String | 可选 | 数字水印的文字内容(当选择的转码模板内设置了文字类型数字水印,创建任务时才可以设置该字段以覆盖模板内容) | 长度4 ~ 40 | - |
+digitalWmSecretKeyId | String | 可选 | 数字水印密钥模板ID | 需从用户已创建的数字水印密钥模板选择,生效优先级高于转码模板中的密钥 | - |
请求示例
POST /v3/job HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2023-11-08T21:21:21Z
host: media.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2023-11-08T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"pipelineName": "high_priority_pipe",
"source": {
"clips": [
{
"bucket": "input",
"sourceKey": "source.mp4"
}
]
},
"target": {
"bucket": "output",
"key": "source_embed.mp4",
"presetName": "embed_preset",
"digitalWmSecretKeyId": "key-pi0nwwuw45zx0ya8",
"digitalWmTextContent": "abcabcabc"
},
}
查询视频数字水印嵌入任务
视频数字水印嵌入任务的查询接口同视频转码任务,请参考视频转码任务接口使用。