智能多媒体服务

  • 智能多媒体服务 > API 文档 > 图片处理 >盲水印处理(watermark)

    盲水印处理(watermark)

    最近更新时间: 2022-03-23 17:01:56

    简介

    肉眼可见的水印方式,一般用于标志图片的出处或者用于声明版权,会破坏原图,且影响美观。七牛提供盲水印功能,隐蔽性强,在不破坏原始作品的情况下,实现版权的防护与追踪。当图片被盗用后,您可对图片进行盲水印解码,验证版权归属。

    七牛提供的盲水印功能有两种类型:

    水印类型 说明
    图片盲水印 将图片作为盲水印添加到图片中
    文字盲水印 将文字作为盲水印添加到图片中

    限制说明

    • 原图限制:

      1. 格式支持 jpg、png
      2. 宽高限制为:4096x4096
      3. version为3时,原图的尺寸宽高都需大于512
      
    • 编码、解码的 version 要相同

    • 盲水印主要为CPU密集型任务,处理时间会随着图片文件的增大而增大

    • 建议使用 version/3,相较于之前的版本有以下优化:

      1. 解水印不需要对比原图,去除对原图的依赖
      2. 抗大面积涂抹&裁剪攻击
      

    应用场景

    隐形美观

    盲水印是一种肉眼不可见的水印方式,可以保持图片美观的同时,保护您的资源版权。

    版权保护

    对图片资源使用图片盲水印或者文字水印,借此避免数字媒体未经授权的复制和拷贝,可通过对原图进行解码操作,得到水印图来证明版权归属。

    防泄漏

    对于内部分享的图片资源,您可使用盲水印功能,加上不同标识,如果资料被复制、传播可根据解码出的唯一标识得出泄露方信息。

    图片盲水印

    接口规格

    watermark/5
             /version/<version>
             /method/<method>
             /imageKey/<encodedImageKey>
             /orignal/<encodedImage>
    

    添加水印

    version 为1或2时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本值为1或2 , 默认为 1。
    /method/<method> Y 盲水印标志位,编码(添加水印)为encode。
    /imageKey/<encodedImageKey> N 水印图片(经过URL安全的Base64编码),图片来源为七牛bucket(需要与输入图片在同一个bucket中)。
    例如:imageKey=upload.png,encodedImageKey=urlsafe_base64_encode(imageKey)。
    注意:水印图片宽高分别不超过原图宽高的二分之一,图片为黑底白字效果更佳。

    version 为3时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本值为3,注意:
    1)原图的宽高都需大于512。
    2)水印图片的限制,必须是二值图像,且水印的大小为64x64,如果不符合条件, 会缩放和处理图片到服务要求。
    /method/<method> Y 盲水印标志位,编码(即添加水印)为encode。
    /imageKey/<encodedImageKey> N 水印图片(经过URL安全的Base64编码),图片来源为七牛bucket(需要与输入图片在同一个bucket中)。
    例如:imageKey=upload.png,encodedImageKey=urlsafe_base64_encode(imageKey)。

    提取水印

    version 为1或2时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本值为1或2 , 默认为 1。
    /method/<method> Y 盲水印标志位,解码(即提取水印)为decode。
    /orignal/<encodedImage> N 解码对比原图(经过URL安全的Base64编码),图片来源为七牛bucket(需要与输入图片在同一个bucket中)。

    version 为3时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本值为3,注意:原图的宽高都需大于512。
    /method/<method> Y 盲水印标志位,解码(即提取水印)为decode。

    示例

    1-1.编码/ 添加盲水印(version/3)

    https://dora-doc.qiniu.com/gogopher1.jpg?watermark/5/version/3/method/encode/imageKey/cWluaXUtbG9nby0zLnBuZw==
    

    查看效果图

    1-2.解码/ 提取盲水印(version/3)

    https://dora-doc.qiniu.com/gogopher1.jpg?watermark/5/version/3/method/encode/imageKey/cWluaXUtbG9nby0zLnBuZw==|watermark/5/version/3/method/decode
    

    查看效果图

    2-1.编码/ 添加盲水印(version/2)

    https://dora-doc.qiniu.com/gogopher.jpg?watermark/5/version/2/method/encode/imageKey/dXBkYXRlLmpwZw==
    

    查看效果图

    2-2.解码/ 提取盲水印(version/2)

    https://dora-doc.qiniu.com/gogopher.jpg?watermark/5/version/2/method/encode/imageKey/dXBkYXRlLmpwZw==|watermark/5/version/2/method/decode/orignal/Z29nb3BoZXIuanBn
    

    查看效果图

    文字盲水印

    接口规格

    watermark/6
             /version/<version>
             /method/<method>
             /text/<encodedText>
             /orignal/<encodedImage>
    

    添加水印

    version 为1和2时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本 可选1、2 , 默认为 1。
    /method/<method> Y 盲水印标志位,编码(添加水印)为encode。
    /text/<encodedText> N 水印文字(经过URL安全的Base64编码)。只支持英文数字字符,不支持中文字符,数量上限分别为 10。

    version 为3时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 版本为3时,注意:原图的宽高都需大于512。
    /method/<method> Y 盲水印标志位,编码(添加水印)为encode。
    /text/<encodedText> N 水印文字(经过URL安全的Base64编码)。只支持英文数字字符,不支持中文字符,数量上限分别为 15。

    提取水印

    version 为1和2时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 接口版本 可选1、2 , 默认为 1。
    /method/<method> Y 盲水印标志位,解码(即提取水印)为decode。
    /orignal/<encodedImage> N 解码对比原图(经过URL安全的Base64编码),图片来源为七牛bucket(需要与输入图片在同一个bucket中)。

    version 为3时,请求参数说明如下:

    名称 必填 说明
    /version/<version> N 版本为3时,注意:原图的宽高都需大于512。
    /method/<method> Y 盲水印标志位,解码(即提取水印)为decode。

    示例

    1-1.编码/ 添加盲水印(version/3)

    https://dora-doc.qiniu.com/gogopher1.jpg?watermark/6/version/3/method/encode/text/MTIzNDU2Nzg5
    

    查看效果图

    1-2.解码/ 提取盲水印(version/3)

    https://dora-doc.qiniu.com/gogopher1.jpg?watermark/6/version/3/method/encode/text/MTIzNDU2Nzg5|watermark/6/version/3/method/decode
    

    查看效果图

    2-1.编码/ 添加盲水印(version/2)

    https://dora-doc.qiniu.com/gogopher.jpg?watermark/6/version/2/method/encode/text/OTAyR0h3cmM=
    

    查看效果图

    2-2.解码/ 提取盲水印(version/2)

    https://dora-doc.qiniu.com/gogopher.jpg?watermark/6/version/2/method/encode/text/OTAyR0h3cmM=|watermark/6/version/2/method/decode/orignal/Z29nb3BoZXIuanBn
    

    查看效果图

    操作方式

    您可以通过 同步处理持久化处理图片样式设置等方式,对图片进行处理,目前盲水印功能不支持 CDN中间源处理,详情介绍请参见图片处理操作方式

    计费说明

    处理类型 价格
    盲水印-添加 1 元/千次
    盲水印-提取 1 元/千次
    以上内容是否对您有帮助?
  • Qvm free helper
    Close