AddWatermark - 添加图文水印模板

为了简化水印任务的处理过程,视频点播将复杂的水印位置、水印大小、水印文字的字体、颜色等水印参数固化成模板,并通过具有唯一性的水印模板ID来指代。调用本接口可以添加图片水印模板或文字水印模板。

接口说明

  • 调用本接口可以添加图片水印模板(Image)或文字水印模板(Text),其中,图片水印模板支持如下格式:静态图片(PNG)、动态图片(GIF、APNG、MOV)。
  • 调用本接口添加图文水印模板后,您还需调用 AddTranscodeTemplateGroupUpdateTranscodeTemplateGroup 接口,将图文水印模板关联到转码模板组上,以便后续发起水印转码时选用。
  • 为视频添加图文水印的详细信息,请参见视频图文水印

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vod:AddWatermark
*全部资源
*

请求参数

名称类型必填描述示例值
Typestring

水印模板类型:

  • Image(默认):图片水印模板。
  • Text:文字水印模板。
Image
Namestring

水印模板名称。

  • 仅支持中英文、数字。
  • 长度不超过 128 个字节。
  • UTF-8 编码。
图片水印模板
WatermarkConfigstring

图文水印的配置信息(JSON 字符串),包括水印显示位置、水印效果等配置。图片水印和文字水印的配置参数不同,参数结构详情,请参见 WatermarkConfig

{ "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" }
FileUrlstring

水印图片文件的 OSS 地址(不带鉴权)。

说明
  • 设置图片水印模板(TypeImage)时,本参数必传。
  • 您可以调用 CreateUploadAttachedMedia 接口将水印图片上传到视频点播中,上传后返回参数FileURL的值可作为本参数的请求参数。
  • http://outin-326268*****63e1403e7.oss-cn-shanghai.aliyuncs.com/image/cover/C99345*****E7FDEC-6-2.png
    AppIdstring

    应用 ID。默认取值:app-1000000。若已开通多应用体系,传入应用 ID,可将水印模板添加到指定应用下。使用说明,请参见多应用体系

    app-****

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    25818875-5F78-4A*****F6-D7393642CA58
    WatermarkInfoobject

    水印模板信息。

    CreationTimestring

    水印模板的创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    2018-11-07T09:05:52Z
    Typestring

    水印模板的类型。

    • Image:图片水印模板。
    • Text:文字水印模板。
    Image
    IsDefaultstring

    是否是默认图文水印模板:

    • Default:默认图文水印模板。
    • NotDefault:非默认图文水印模板。
    NotDefault
    FileUrlstring

    水印文件 URL(OSS 地址或 CDN 地址)。

    说明 仅图片水印模板会返回此参数。
    https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****
    WatermarkConfigstring

    图文水印的配置信息(JSON 字符串),包括水印显示位置、水印效果等配置。图片水印和文字水印的配置参数不同,参数结构详情,请参见 WatermarkConfig

    { "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" }
    Namestring

    水印模板名称。

    图片水印模板
    WatermarkIdstring

    水印模板 ID。后续可使用该水印模板 ID 关联到转码模板组,或对水印模板进行查询、修改、删除、设置默认水印模板等操作。

    9bcc8bfadb84*****109a2671d0df97

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
      "WatermarkInfo": {
        "CreationTime": "2018-11-07T09:05:52Z",
        "Type": "Image",
        "IsDefault": "NotDefault",
        "FileUrl": "https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
        "WatermarkConfig": "{\n      \"Width\": \"55\",\n      \"Height\": \"55\",\n      \"Dx\": \"9\",\n      \"Dy\": \"9\",\n      \"ReferPos\": \"BottomLeft\"\n}",
        "Name": "图片水印模板",
        "WatermarkId": "9bcc8bfadb84*****109a2671d0df97"
      }
    }

    错误码

    访问错误中心查看更多错误码。

    接口错误码

    下表列举了本接口特有的错误码。

    错误代码错误信息HTTP 状态码说明
    NoSuchResourceThe specified resource %s does not exist.404用户相关的资源数据不存在,%s 表示具体资源信息。