tencent cloud

PrevNext

文档反馈

请输入关键字

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）即可。
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款