Tencent Cloud

Recent Pages

盲水印

最后更新时间：2023-12-22 10:53:47

功能描述
盲水印功能基于腾讯云数据万象，是一种全新的水印模式。通过该功能，您可将水印图以不可见的形式添加到原图信息中，并且不会对原图质量产生太大影响。当发现图片被盗取后，您可对疑似被盗取的资源进行盲水印提取，验证图片归属。
通过该 API 接口，您可以：
在上传时为图片添加盲水印
在下载时为图片添加盲水印
对 COS 上的图片添加盲水印
也可以对已添加盲水印的图片进行盲水印提取。
说明
暂不支持为动图（例如 GIF 图片）添加盲水印。
使用盲水印功能，水印图的宽高不得超过原图的1/8。
为保证盲水印效果，水印图请选用黑底白色图片。
文字盲水印当前支持数字[0 - 9]及英文大小写[A - Z,a - z]。
盲水印可抵抗裁剪、涂抹、变色等多种图片盗取攻击，防盗效果与原图大小及攻击程度相关。如需详细咨询请 提交工单。
盲水印已支持数据万象所有地域，详情请查看 地域与域名。
添加盲水印
请求一：上传时添加盲水印
图片上传时添加盲水印的请求包与 PUT Object 接口一致，只需在请求包头部增加图片处理参数 Pic-Operations 并使用盲水印参数即可。
请求示例
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: <PicOperations>
﻿
[Object Content]
说明
Authorization: Auth String （详情请参见 请求签名 文档）。
请求头
此接口使用公共请求头部，详情请参见 公共请求头部 文档。
请求包头部增加图片处理参数 Pic-Operations，Pic-Operations 为 json 格式的字符串，具体参数如下：
参数名称
描述
类型
是否必选
is_pic_info
是否返回原图信息。0表示不返回原图信息，1表示返回原图信息，默认为0
Int
否
rules
处理规则，一条规则对应一个处理结果（目前最多支持五条规则），不填则不进行图片处理
Array
否
rules（json 数组）中每一项具体参数如下：
参数名称
描述
类型
是否必选
bucket
存储结果的目标存储桶名称，格式为：BucketName-APPID，如果不指定的话默认保存到当前存储桶
String
否
fileid
处理后文件的保存路径及名称。名称规则说明：
例如源文件的路径及文件名为：/p1/test1.jpg
1. 以/开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件
2.  不以/开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 p1 文件夹中新建了一个 p2 文件夹，然后在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件
3.  注意：请不要以/结尾，否则会产生空文件名
String
是
rule
处理参数，可参见图片处理 API。 若按指定样式处理，则以style/开头，后加样式名，如样式名为“test”，则 rule 字段为style/test
String
是
使用盲水印需在 rule 中添加水印图参数（watermark），示例格式如下：
watermark/3/type/<type>/image/<imageUrl>/text/<text>/level/<level>
示例参数说明如下：
参数名称
描述
类型
是否必选
type
盲水印类型，有效值：1为半盲水印；2为全盲水印；3为文字盲水印
Int
是
image
盲水印图片地址，需要经过 URL 安全的  Base64 编码。 当 type 为1或2时必填，type 为3时无效。 指定的水印图片必须同时满足如下条件：
1. 盲水印图片与原图片必须位于同一个存储桶下
2. URL 必须以http://开始，不能省略 http 头，也不能填 https 头，例如以下地址为非法水印地址：examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
String
否
text
盲水印文字，需要经过 URL 安全的 Base64 编码。当 type 为3时必填，type 为1或2时无效
String
否
level
只对全盲水印（type=2）有效。level 的取值范围为{1,2,3}，默认值为1，level 值越大则图片受影响程度越大、盲水印效果越好。
Int
否
请求参数
此接口无请求参数。
请求体
此接口请求的请求体为需要添加盲水印的原文件（图片）内容。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
响应体具体数据内容如下：
参数名称
描述
类型
UploadResult
原图信息
Container
UploadResult 节点内容： 
参数名称
描述
类型
OriginalInfo
原图信息
Container
ProcessResults
图片处理结果
Container
OriginalInfo 节点内容： 
节点名称
描述
类型
Key
原图文件名
String
Location
图片路径
String
ImageInfo
原图图片信息
Container
ImageInfo 节点内容： 
节点名称
描述
类型
Format
格式
String
Width
图片宽度
Int
Height
图片高度
Int
Quality
图片质量
Int
Ave
图片主色调
String
Orientation
图片旋转角度
Int
ProcessResults 节点内容：
节点名称
描述
类型
Object
每一个图片处理结果
Container
Object 节点内容：
节点名称
描述
类型
Key
文件名
String
Location
图片路径
String
Format
图片格式
String
Width
图片宽度
Int
Height
图片高度
Int
Size
图片大小
Int
Quality
图片质量
Int
实际案例
请求
PUT /exampleobject HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2018 09:06:15 GMT
Authorization:XXXXXXXXXXXX
﻿
Pic-Operations:
{
    "is_pic_info": 1,
    "rules": [{
        "fileid": "exampleobject",
        "rule": "watermark/3/type/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn"
    }]
}
Content-Length: 64
﻿
[Object Content]
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
﻿
<UploadResult>
          <OriginalInfo>
              <Key>exampleobject</Key>
              <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
              <ImageInfo>
                   <Format>JPEG</Format>
                   <Width>640</Width>
                   <Height>427</Height>
                   <Quality>100</Quality>
                   <Ave>0xa18454</Ave>
                   <Orientation>1</Orientation>
              </ImageInfo>
          </OriginalInfo>
          <ProcessResults>
              <Object>
                   <Key>exampleobject</Key>
                   <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
                   <Format>png</Format>
                   <Width>640</Width>
                   <Height>427</Height>
                   <Size>463092</Size>
                   <Quality>100</Quality>
              </Object>
          </ProcessResults>
</UploadResult>
注意
请求体的 [Object Content] 字段为原图的图片内容(二进制字符串)，请求头 Pic-Operations 的 rule 字段中，imageUrl 为水印图片的地址。
响应体的 ProcessResults 中的 Location 字段为处理后已经携带盲水印的图片的地址。
请求二：下载时添加盲水印
图片下载时添加盲水印与添加普通水印操作相同，只需在图片访问链接后使用 watermark 参数即可。
请求示例
GET /<ObjectKey>?watermark/3/type/<type>/image/<imageUrl>/text/<text> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
请求参数
请求参数说明如下：
参数
描述
类型
是否必选
download_url
文件的访问链接，具体构成为 http(s)://<BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>， 例如examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg
String
是
type
盲水印类型，有效值：1为半盲水印；2为全盲水印；3为文字盲水印
Int
是
image
盲水印图片地址，需要经过 URL 安全的  Base64 编码。 当 type 为1或2时必填，type 为3时无效。 指定的水印图片必须同时满足如下条件：
1. 盲水印图片与原图片必须位于同一个存储桶下
2.  URL 必须以http://开始，不能省略 http 头，也不能填 https 头，例如以下地址为非法水印地址：
examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
String
否
text
盲水印文字，需要经过 URL 安全的 Base64 编码。当 type 为3时必填，type 为1或2时无效
String
否
level
只对全盲水印（type=2）有效。level 的取值范围为{1,2,3}，默认值为1，level 值越大则图片受影响程度越大、盲水印效果越好
Int
否
实际案例
https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/sample.jpeg?watermark/3/type/3/text/dGVuY2VudCBjbG91ZA==
请求三：对 COS 上的图片添加盲水印
通过 API 能够对已存储在 COS 的图片进行添加盲水印的操作，并将结果存入到 COS。
请求示例
POST /<ObjectKey>?image_process HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: <PicOperations>
说明
Authorization: Auth String（详情请参见 请求签名 文档）。
请求头
此接口使用公共请求头部，详情请参见 公共请求头部 文档。
请求包头部增加图片处理参数 Pic-Operations，Pic-Operations 为 json 格式的字符串，具体参数如下：
参数名称
描述
类型
是否必选
is_pic_info
是否返回原图信息。0表示不返回原图信息，1表示返回原图信息，默认为0
Int
否
rules
处理规则，一条规则对应一个处理结果（目前最多支持五条规则），不填则不进行图片处理
Array
否
rules（json 数组）中每一项具体参数如下：
参数名称
描述
类型
是否必选
bucket
存储结果的目标存储桶名称，格式为：BucketName-APPID，如果不指定的话默认保存到当前存储桶
String
否
fileid
处理后文件的保存路径及名称。名称规则说明：例如源文件的路径及文件名为：/p1/test1.jpg
1. 以/开头为绝对路径，例如 fileid 值为/p2/test2.jpg时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件
2. 不以/开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 p1 文件夹中新建了一个 p2 文件夹，然后在p2文件夹中存储了一个文件名为 test2.jpg 的文件
3. 注意：请不要以/结尾，否则会产生空文件名
String
是
rule
处理参数，可参见图片处理 API。 若按指定样式处理，则以style/开头，后加样式名，如样式名为“test”，则 rule 字段为style/test
String
是
使用盲水印需在 rule 中添加水印图参数（watermark），示例格式如下：
watermark/3/type/<type>/image/<imageUrl>/text/<text>/level/<level>
示例参数说明如下：
参数
描述
类型
是否必选
type
盲水印类型，有效值：1为半盲水印；2为全盲水印；3为文字盲水印
Int
是
image
盲水印图片地址，需要经过 URL 安全的 Base64 编码。当 type 为1或2时必填，type 为3时无效。指定的水印图片必须同时满足如下条件：
1. 盲水印图片与原图片必须位于同一个存储桶下
2.  URL 必须以http://开始，不能省略 http 头，也不能填 https 头，例如以下地址为非法水印地址：
examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
String
否
text
盲水印文字，需要经过 URL 安全的 Base64 编码。当 type 为3时必填，type 为1或2时无效。
String
否
level
只对全盲水印（type=2）有效。level 的取值范围为{1,2,3}，默认值为1，level 值越大则图片受影响程度越大、盲水印效果越好
Int
否
请求参数
此接口无请求参数。
请求体
此接口无请求体。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
响应体具体数据内容如下：
参数名称
描述
类型
UploadResult
原图信息
Container
UploadResult 节点内容： 
参数名称
描述
类型
OriginalInfo
原图信息
Container
ProcessResults
图片处理结果
Container
OriginalInfo 节点内容： 
节点名称
描述
类型
Key
原图文件名
String
Location
图片路径
String
ImageInfo
原图图片信息
Container
ImageInfo 节点内容： 
节点名称
描述
类型
Format
格式
String
Width
图片宽度
Int
Height
图片高度
Int
Quality
图片质量
Int
Ave
图片主色调
String
Orientation
图片旋转角度
Int
ProcessResults 节点内容：
节点名称
描述
类型
Object
每一个图片处理结果
Container
Object 节点内容：
节点名称
描述
类型
Key
文件名
String
Location
图片路径
String
Format
图片格式
String
Width
图片宽度
Int
Height
图片高度
Int
Size
图片大小
Int
Quality
图片质量
Int
实际案例
请求
POST /exampleobject?image_process HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2018 09:06:15 GMT
Authorization:XXXXXXXXXXXX
﻿
Pic-Operations:
{
    "is_pic_info": 1,
    "rules": [{
        "fileid": "exampleobject",
        "rule": "watermark/3/type/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn"
    }]
}
Content-Length: 64
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
﻿
<UploadResult>
          <OriginalInfo>
              <Key>exampleobject</Key>
              <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
              <ImageInfo>
                   <Format>JPEG</Format>
                   <Width>640</Width>
                   <Height>427</Height>
                   <Quality>100</Quality>
                   <Ave>0xa18454</Ave>
                   <Orientation>1</Orientation>
              </ImageInfo>
          </OriginalInfo>
          <ProcessResults>
              <Object>
                   <Key>exampleobject</Key>
                   <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject</Location>
                   <Format>png</Format>
                   <Width>640</Width>
                   <Height>427</Height>
                   <Size>463092</Size>
                   <Quality>100</Quality>
              </Object>
          </ProcessResults>
</UploadResult>
提取盲水印
请求一：上传时提取盲水印
请求示例
上传图片并提取盲水印的请求包与 PUT Object 接口一致，只需在请求包头部增加图片处理参数 Pic-Operations 并使用提取盲水印参数（watermark/4）即可。
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization:XXXXXXXXXXXX
Pic-Operations: <PicOperations>
﻿
[Object Content]
说明
Authorization: Auth String （详情请参见 请求签名 文档）。
请求头
此接口使用公共请求头部，详情请参见 公共请求头部 文档。
请求包头部增加图片处理参数 Pic-Operations，Pic-Operations 为 json 格式的字符串，具体参数如下：
参数名称
描述
类型
是否必选
is_pic_info
是否返回原图信息。0表示不返回原图信息，1表示返回原图信息，默认为0
Int
否
rules
处理规则，一条规则对应一个处理结果（目前最多支持五条规则），不填则不进行图片处理
Array
否
rules（json 数组）中每一项具体参数如下：
参数名称
描述
类型
是否必选
bucket
存储结果的目标存储桶名称，格式为：BucketName-APPID，如果不指定的话默认保存到当前存储桶
String
否
fileid
处理后文件的保存路径及名称。名称规则说明：例如源文件的路径及文件名为：/p1/test1.jpg
1. 以/开头为绝对路径，例如 fileid 值为 /p2/test2.jpg 时，表示在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件
2.  不以/开头为相对路径，例如 fileid 值为 p2/test2.jpg 时，表示在 p1 文件夹中新建了一个 p2 文件夹，然后在 p2 文件夹中存储了一个文件名为 test2.jpg 的文件
3.  注意：请不要以/结尾，否则会产生空文件名
String
是
rule
处理参数，请参见图片处理 API。 若按指定样式处理，则以style/开头，后加样式名，如样式名为“test”，则 rule 字段为style/test
String
是
提取盲水印需在 rule 中添加水印图参数（watermark），示例格式如下：
watermark/4/type/<type>/image/<imageUrl>
示例参数说明如下：
参数名称
描述
类型
是否必选
type
盲水印类型，有效值：1为半盲水印；2为全盲水印；3为文字盲水印，必须跟添加盲水印时的 type 类型一致。
Int
是
image
图片地址，根据 type 值填写：
当 type 为1，则 image 必填，且为原图图片地址
当 type 为2，则 image 必填，且为水印图地址
当 type 为3，则 image 无需填写（无效）
image 需要经过 URL 安全的 Base64 编码，指定的图片必须同时满足如下条件：
1. 图片与存在水印的图片必须位于同一个对象存储桶下；
2.  URL 必须以http://开始，不能省略 http 头，也不能填 https 头，例如以下地址为非法水印地址：
examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png
String
否
请求参数
此接口无请求参数。
请求体
此接口请求的请求体为图片内容。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
响应体的 UploadResult.ProcessResults.Object 字段中新增 WatermarkStatus 字段，当盲水印提取的请求体中 type 参数为2时携带 WatermarkStatus 参数，其他情况不返回该参数。
参数名称
父节点
描述
类型
WatermarkStatus
Object
当 type 为2时返回该字段，表示提取到全盲水印的可信度。具体为0-100的数字，75分以上表示确定有盲水印，60-75表示疑似有盲水印，60以下可认为未提取到盲水印
Int
实际案例
请求
PUT /exampleobject1 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2018 09:06:15 GMT
Authorization:XXXXXXXXXXXX
﻿
Pic-Operations:
{
    "is_pic_info": 1,
    "rules": [{
        "fileid": "exampleobject2",
        "rule": "watermark/4/type/2/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL2ZpbGVuYW1lLmpwZWc="
    }]
}
Content-Length: 64
﻿
[Object Content]
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****
﻿
<UploadResult>
      <OriginalInfo>
          <Key>exampleobject1</Key>
          <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject1</Location>
          <ImageInfo>
                <Format>JPEG</Format>
                <Width>640</Width>
                <Height>427</Height>
                <Quality>100</Quality>
                <Ave>0xa18454</Ave>
                <Orientation>1</Orientation>
                <FrameCount>1</FrameCount>
          </ImageInfo>
      </OriginalInfo>
      <ProcessResults>
          <Object>
                <Key>exampleobject2</Key>
                <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/exampleobject2</Location>
                <Format>png</Format>
                <Width>640</Width>
                <Height>427</Height>
                <Size>463092</Size>
                <Quality>100</Quality>
                <FrameCount>1</FrameCount>
                <WatermarkStatus>86</WatermarkStatus>
          </Object>
      </ProcessResults>
</UploadResult>
注意
对于 type 值为1的请求，请求头 Pic-Operations 的 rule 字段中，imageUrl 为未添加盲水印的原图地址；对于 type 值为2的请求，包头 Pic-Operations 的 rule 字段中，imageUrl 为水印图的地址。
响应体 ProcessResults 字段的 url 为提取出来的水印图地址。
请求二：对 COS 上的图片提取盲水印
对 COS 上的图片提取盲水印的请求包与 云上数据处理 接口一致，只需在请求包头部增加图片处理参数 Pic-Operations 并使用提取盲水印参数（watermark/4）即可。

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

参数名称	描述	类型	是否必选
is_pic_info	是否返回原图信息。0表示不返回原图信息，1表示返回原图信息，默认为0	Int	否
rules	处理规则，一条规则对应一个处理结果（目前最多支持五条规则），不填则不进行图片处理	Array	否

节点名称	描述	类型
Key	原图文件名	String
Location	图片路径	String
ImageInfo	原图图片信息	Container

参数	描述	类型	是否必选
download_url	文件的访问链接，具体构成为 http(s)://`<BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>`，例如`examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg`	String	是
type	盲水印类型，有效值：1为半盲水印；2为全盲水印；3为文字盲水印	Int	是
image	盲水印图片地址，需要经过 URL 安全的 Base64 编码。当 type 为1或2时必填，type 为3时无效。指定的水印图片必须同时满足如下条件： 1. 盲水印图片与原图片必须位于同一个存储桶下 2. URL 必须以http://开始，不能省略 http 头，也不能填 https 头，例如以下地址为非法水印地址： examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png https://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/watermark.png	String	否
text	盲水印文字，需要经过 URL 安全的 Base64 编码。当 type 为3时必填，type 为1或2时无效	String	否
level	只对全盲水印（type=2）有效。level 的取值范围为{1,2,3}，默认值为1，level 值越大则图片受影响程度越大、盲水印效果越好	Int	否

参数名称	父节点	描述	类型
WatermarkStatus	Object	当 type 为2时返回该字段，表示提取到全盲水印的可信度。具体为0-100的数字，75分以上表示确定有盲水印，60-75表示疑似有盲水印，60以下可认为未提取到盲水印	Int

tencent cloud

注册

登录

Recent Pages

盲水印

功能描述

添加盲水印

请求一：上传时添加盲水印

请求示例

请求头

请求参数

请求体

响应

响应头

响应体

实际案例

请求

响应

请求二：下载时添加盲水印

请求示例

请求参数

实际案例

请求三：对 COS 上的图片添加盲水印

请求示例

请求头

请求参数

请求体

响应

响应头

响应体

实际案例

请求

响应

提取盲水印

请求一：上传时提取盲水印

请求示例

请求头

请求参数

请求体

响应

响应头

响应体

实际案例

请求

响应

请求二：对 COS 上的图片提取盲水印

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？