EncodeBlindWatermark - 添加图片盲水印

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

接口说明

  • 该接口不依赖媒体集。
  • 智能媒体管理支持将图片、文字作为盲水印添加到图片中。

注意事项

  • 当添加盲水印的图片经过变换后,例如压缩、缩放等,图片的水印可能难以解析。
  • 对同一张图片,添加盲水印和解析盲水印时必须使用同一种算法,否则图片的水印无法进行解析。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
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"
    }

    错误码

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

    阿里云首页 智能媒体管理 相关技术圈