EncodeBlindWatermark - 添加图片盲水印

更新时间: 2024-11-26 16:15:48

在图片中不能直接看到该水印,但可以通过DecodeBlindWatermark恢复图中隐藏的水印。

接口说明

  • 此接口已不再维护,建议使用新版(2020-09-30 版本)API。关于新版与旧版 API 的对比,请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。

  • 此接口不依赖媒体集。

  • 智能媒体管理支持将图片、文字作为盲水印添加到图片中。

  • 当添加盲水印的图片经过变换后,例如压缩、缩放等,图片的水印可能难以解析。

  • 对同一张图片,添加盲水印和解析盲水印时必须使用同一种算法,否则图片的水印无法进行解析。

调试

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

授权信息

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

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

请求参数

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

项目名称。

immimagetest
ImageUristring

待添加盲水印图片的 OSS URI。

OSS 地址规则为oss://bucket/object,其中 bucket 为和当前项目处于同一区域的 OSS Bucket 名称,object 为文件路径。

oss://imm-test/testcases/watermarktestbefore.jpg
WatermarkUristring

水印图片的 OSS 地址。OSS 地址规则为oss://bucket/object,其中 bucket 为和当前项目处于同一地域的 OSS Bucket 名称,object 为文件路径。

说明
  • 水印图片的大小建议不要超过 2000 px。
  • 参数 WatermarkUri 和参数 Content 必须至少设置一个。
  • oss://imm-test/testcases/test.jpg
    TargetUristring

    添加盲水印后图片保存到的 OSS URI。

    OSS 地址规则为oss://bucket/object,其中 bucket 为和当前项目处于同一区域的 OSS Bucket 名称,object 为文件路径。

    oss://imm-test/testcases/watermarktestafter.jpg
    ImageQualitystring

    输出图片的质量,默认值为 90,取值范围为 70~100。

    质量越高,图片尺寸越大,水印解析质量越高。

    90
    Contentstring

    作为水印的文字内容,最多 100 字节。

    WatermarkUri 参数和 Content 参数必须至少设置一个。

    阿里云版权所有
    TargetImageTypestring

    加水印后图片的存储格式,默认值为 jpg,可选值包括 jpg 和 png。

    jpg
    Modelstring

    水印算法模型,默认值为 FFT,可选值包括 FFT、FFT_FULL、DWT 和 DWT_IBG,推荐您使用 DWT_IBG。

    不同算法模型的区别请参见算法模型。

    DWT_IBG

    算法模型

    模型名称解码是否需要原图抗攻击能力计算速度限制
    FFTY较弱一般对色彩不够丰富的图片(例如线框图),添加盲水印后,图片可能会泛黄。
    FFT_FULLY一般图片比 FFT 泛黄的概率小,但是速度会降低。
    DWTN较好任意大小水印都可以用,但是有效水印信息为 64 px×64 px 的二值图。
    无论输入何种水印图,该算法都会先变换水印图为 64 px×64 px 的二值图,所以当输入彩色水印或者非常大的水印时会存在信息损失。
    被添加水印的图片大小不能过小,且较短边长需大于 128 像素。
    DWT_IBGN较好DWT 的优化方案,对纯色背景图片影响更小,对非纯色背景图片清晰度更高。

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    当次请求的 Request ID。

    8E0DD64B-28C6-4653-8FF7-93E4C234BCF0
    Contentstring

    只有当请求中设置了 Content 参数时,才有显示此参数。

    作为水印的文字内容。

    阿里云版权所有
    TargetUristring

    添加水印后图片保存到的 OSS URI。

    oss://imm-test/testcases/watermarktestafter.jpg

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "8E0DD64B-28C6-4653-8FF7-93E4C234BCF0",
      "Content": "阿里云版权所有",
      "TargetUri": "oss://imm-test/testcases/watermarktestafter.jpg"
    }

    错误码

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

    上一篇: 图片盲水印 下一篇: DecodeBlindWatermark - 解析图片盲水印
    阿里云首页 智能媒体管理 相关技术圈