调用 CreateWatermarkPresetV2 接口，添加水印模板。添加完成后您需要在推流时将直播流与水印模板绑定，在完成水印模板绑定后，当前直播流的所有转码流都会携带该水印。

使用说明

在推流时绑定水印模板，需要在推流地址中携带 wm 参数（取值 1 表示开启水印，取值 0 表示关闭水印）和 任一模板标识（wmid 表示模板 ID，wmname 表示模板名称）。
例如，推流时您可以使用 rtmp://push.example.com/live/stream?wm=1&wmid=12344567 或 rtmp://push.example.com/live/stream?wm=1&wmname=example 地址实现直播流和水印模板的绑定。

注意事项

• 请求频率：单用户请求频率限制为 5 次/秒。
• 生效说明：新增、变更、删除水印模板，均需在新增、变更、删除操作后（3-5 分钟）重新进行推拉流才会使用变更后的配置。

请求说明

• 请求方式：POST
• 请求地址：https://live.volcengineapi.com?Action=CreateWatermarkPresetV2&Version=2023-01-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请见返回结构。

请求示例

POST https://live.volcengineapi.com?Action=CreateWatermarkPresetV2&Version=2023-01-01
{
    "PictureUrl": "https://example.com/watermark-image.jpg",
    "PreviewWidth": 1920,
    "PreviewHeight": 1080,
    "RelativeHeight": 0.1,
    "PosX": 0,
    "PosY": 0,
    "PresetName": "watermark001"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateWatermarkPresetV2",
        "Version": "2023-01-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "ID": 12344567,
        "PresetName": "watermark001"
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。