图片水印

接口

imgWaterMark

描述

金山云提供三种水印功能，包括文字水印、图片水印，以及多重水印。如果你拥有对图片文件的读权限，那么你可以对该图片添加水印。通过添加水印，你可以制作个性的图片，或者标识图片来源以及版权信息。

说明

1. 权限

该接口操作需要具备ks3:GetObject权限。

2. 图片水印

水印源图片URL目前仅支持HTTP协议，若使用HTTPS，会返回状态码400错误。 对于部分汉字水印，样式编码时可能会出现‘+’、‘/’等特殊字符，这时需要在URL对这些字符进行转译才能正常访问，具体转译见下表：

3.文字水印

文字水印支持的字体类型详见下表

请求（文字水印）

语法

https://BucketName.${bucket所在region的域名}/object@base@
    tag=imgWaterMark
    &type=2
    &text=<base64EncodeText>
    &font=<base64EncodeFont>
    &fontsize=<fontsize>
    &fill=<base64EncodeFill>
    &dissolve=<dissolve>
    &gravity=<gravity>
    &dx=<offsetX>
    &dy=<offsetY>

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

请求参数

水印锚点参数列表

请求头部

该请求不需要设置特殊的头部。

请求（图片水印）

语法

https://BucketName.ks3-cn-beijing.ksyuncs.com/object@base@
    tag=imgWaterMark  
    &type=1  
    &dissolve=<dissolve>  
    &gravity=<gravity>  
    &image=<base64EncodeImageURI>  
    &dx=<offsetX>  
    &dy=<offsetY>
    &wtw=<width>
    &wth=<height>   HTTP/1.1
Host: BucketName.ks3-cn-beijing.ksyuncs.com

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

请求参数

水印锚点参数列表

请求头部

该请求不需要设置特殊的头部。

响应：

响应头部

响应内容

• 如果请求处理成功，返回图片的二进制图片数据。

• 如果请求失败，则返回如下JSON格式的内容：

  
  {
      "errorCode": <HttpCode int>,
      "tipInfo": <ErrorTipInfo String>,
  }

特殊错误

示例

如下所示为一些关于水印功能的简单示例：

请求示例（文字水印）

• 水印文字：金山云

  • 原始水印文字=金山云

  • 加密水印文字(base64)=6YeR5bGx5LqR

  • text=6YeR5bGx5LqR

• 水印文字字体：微软雅黑

  • 原始文字字体=微软雅黑

  • 加密水印字体(base64)=5b6u6L2v6ZuF6buR

  • font=5b6u6L2v6ZuF6buR

• 水印文字颜色：## bf1717(红色)

  • 原始字体颜色=## bf1717

  • 加密字体颜色(base64)=I2JmMTcxNw==

  • fill=I2JmMTcxNw==

• 水印字体大小：500 (单位:缇)

  • fontsize=500

  • 水印位置:右上角

  • gravity=NorthEast

• 水印不透明度:65%

  • dissolve=65

• 横轴边距:10

  • dx=10

• 纵轴边距:10

  • dy=10

请求代码

https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark
    &type=2
    &dissolve=65
    &gravity=NorthEast
    &text=6YeR5bGx5LqR
    &font=5b6u6L2v6ZuF6buR
    &fill=I2JmMTcxNw==
    &fontsize=500
    &dy=10
    &dx=20

注意：接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

响应示例

请求示例（图片水印）

• 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 原始图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

• 水印位置:右上角

  • gravity=NorthEast

• 水印不透明度:65%

  • dissolve=65

• 横轴边距:10

  • dx=10

• 纵轴边距:10

  • dy=10

请求代码

https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy1yZXNvdXJjZXMua3MzLWNuLWJlaWppbmcua3N5dW5jcy5jb20vZml4ZWRfa3NjX2xvZ28ucG5n
    &dy=10   
    &dx=10   

注意：

• 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

• 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例

请求示例（多重水印）

多重水印，包括对同一张图片可以执行两种或多种操作(基本图片操作和图片水印)，两种操作直接用"|"间隔就OK了。

• 宽度为200px，高度为150px

• 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

• 水印位置:右下角

  • gravity=SouthEast

• 水印不透明度:65%

  • dissolve=65

• 横轴边距:10

  • dx=10

• 纵轴边距:10

  • dy=10

请求代码

https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgScale   
    &mode=0   
    &h=160   
    &w=220   
    |tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10
    |tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=SouthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10   

注意：

• 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

• 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例

请求示例（图片水印阈值示例）

• 水印链接: http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 原始图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

• 水印位置:右上角

  • gravity=NorthEast

• 水印不透明度:65%

  • dissolve=65

• 横轴边距:10

  • dx=10

• 纵轴边距:10

  • dy=10

• 宽度阈值:500

  • wtw=500

• 高度阈值:500

  • wth=500

请求代码

https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
    tag=imgWaterMark   
    &type=1   
    &dissolve=65   
    &gravity=NorthEast   
    &image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
    &dy=10   
    &dx=10
    &wtw=500
    &wth=500   

注意：

• 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

• 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

  响应示例

  

请求示例（同时设置文字水印和图片水印）

同时设置文字水印和图片水印，包括对同一张图片可以同时设置文字水印和图片水印。

• 水印图片URI= http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png

  • 加密URI(base64)=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=

  • 水印位置:右上角

    • gravity=NorthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:10

    • dx=10

  • 纵轴边距:10

    • dy=10

• 水印文字：金山云

  • 原始水印文字=金山云

  • 加密水印文字(base64)=6YeR5bGx5LqR

  • text=6YeR5bGx5LqR

  • 水印位置:右上角

    • gravity=NorthEast

  • 水印不透明度:65%

    • dissolve=65

  • 横轴边距:50

    • dx=50

  • 纵轴边距:50

    • dy=50

请求代码

https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
  tag=imgWaterMark
  &type=1
  &dissolve=65
  &gravity=NorthEast
  &image=aHR0cDovL2tzMy1yZXNvdXJjZXMua3MzLWNuLWJlaWppbmcua3N5dW5jcy5jb20vZml4ZWRfa3NjX2xvZ28ucG5n
  &dy=10
  &dx=10
  tag=imgWaterMark
  &type=2
  &dissolve=65
  &gravity=NorthEast
  &text=6YeR5bGx5LqR
  &font=5b6u6L2v6ZuF6buR&fill=I2JmMTcxNw==&fontsize=500
  &dy=50
  &dx=50

注意：

• 接口格式不含任何空格与换行符，以上内容为了方便阅读做了格式化。

• 制作图片水印时，注意加密的水印链接需以"http"开头，否则会返回400错误。

响应示例