图像水印

最近更新时间:2021-01-20 17:48:31

查看PDF

接口

imgWaterMarker

描述

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

说明

1.权限

该接口操作需要具备GetObject权限,假如获取对象不存在,你可能存在以下两种返回:

假如用户具有该对象所在Bucket的ListBucket权限,会返回状态码404错误;
假如用户不具备该对象所在Bucket的ListBucket权限,会返回状态码403错误。

2.图片水印

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

特殊字符 url中表示结果 转移码(%+ASCII码)
+ URL 中+号表示空格 %2B
空格 URL中的空格可以用+号或者编码 %20
/ 分隔目录和子目录 %2F
? 分隔实际的URL和参数 %3F
* 指定特殊字符 %25
# 表示书签 %23
& URL 中指定的参数间的分隔符 %26
= URL 中指定参数的值 %3D

请求:

文字水印

语法

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

https://BucketName.${bucket所在region的域名}/[email protected]@
	tag=imgWaterMarker
	&type=2
	&text=<base64EncodeText>
	&font=<base64EncodeFont>
	&fontsize=<base64EncodeFontSize>
	&fill=<base64EncodeFill>
	&dissolve=<dissolve>
	&gravity=<gravity>
	&dx=<offsetX>
	&dy=<offsetY>   HTTP/1.1
Host: BucketName.${bucket所在region的域名}
请求参数
参数名称 必填 解释说明
tag 操作标志
type type=2 文字水印
text 水印文字(base64EncodeText,经过URL安全的Base64编码)
font 文字水印字体(base64EncodeFont,经过URL安全的Base64编码)。默认为黑体
fontsize 字体大小(整形),单位为缇(1缇=1/20磅),默认值500
fill 文字水印颜色(base64EncodeFill,经过URL安全的Base64编码),可以是RGB格式,也可以是颜色名称(例如 black),还可以是十六进制(例如 ## FF0000),可以参考RGB对照表
dissolve 不透明度。取值范围为1~100,默认值为100。100为完全不透明。
gravity 水印位置。可参考下面的水印锚点参数表,默认为SouthEast(右下方)。
dx 横轴(x轴)边距,单位为像素(px),默认值为10
dy 纵轴(y轴)边距,单位为像素(px),默认值为10
q 决定 jpg 图片的相对quality,对原图压缩。范围为0-100 , 0表示高压缩低质量,100表示低压缩,高质量。默认90
水印锚点参数列表
NorthWest North NorthEast
West Center East
SouthWest South SouthEast
请求头部

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

图像水印

语法

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

https://BucketName.ks3-cn-beijing.ksyun.com/[email protected]@
	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.ksyun.com
请求参数
参数名称 必填 解释说明
tag 操作标志
type type=1 为图片水印
image 水印源图片网址(base64EncodeImageURI,经过URL安全的Base64编码),必须保证此网址返回一张图片
dissolve 不透明度。取值范围为1~100,默认值为100。100为完全不透明。
gravity 水印位置。可参考下面的水印锚点参数表,默认为SouthEast(右下方)。
dx 横轴(x轴)边距,单位为像素(px),默认值为10
dy 纵轴(y轴)边距,单位为像素(px),默认值为10
q 决定 jpg 图片的相对quality,对原图压缩。范围为0-100 , 0表示高压缩低质量,100表示低压缩,高质量。默认90
wtw 水印添加宽度阈值,小于该值将不进行图片水印操作,单位为像素(px)。范围为0以上的整数
wth 水印添加高度阈值,小于该值将不进行图片水印操作,单位为像素(px)。范围为0以上的整数
水印锚点参数列表
NorthWest North NorthEast
West Center East
SouthWest South SouthEast
请求头部

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

响应:

响应头部
头部名称 必填 说明
Content-Type MIME类型,成功时为图片固定的MIME类型image/*,失败时为application/json
响应内容
  • 如果请求处理成功,返回图片的二进制图片数据。

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

      {
      	"errorCode": <HttpCode int>,
      	"tipInfo": <ErrorTipInfo String>,
      }
    
特殊错误
HTTP状态码 含义
400 请求报文格式错误
404 资源不存在
403 访问拒绝
500 服务端操作失败。

示例

一些关于水印功能的简单示例

文字水印示例
示例请求
  • 水印文字:金山云
    • 原始水印文字=金山云
    • 加密水印文字(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-cn-beijing.ksyun.com/ks3-resources/[email protected]@
	tag=imgWaterMark
	&type=2
	&dissolve=65
	&gravity=NorthEast
	&text=6YeR5bGx5LqR
	&font=5b6u6L2v6ZuF6buR
	&fill=I2JmMTcxNw==
	&fontsize=500
	&dy=10
	&dx=20
示例响应

文字水印示例

图片水印示例
示例请求
请求代码

注意:

  • 接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
  • 制作图片水印时,注意加密的水印链接需以"http"开头,否则会返回400错误。
https://ks3-cn-beijing.ksyun.com/ks3-resources/[email protected]@
	tag=imgWaterMark   
	&type=1   
	&dissolve=65   
	&gravity=NorthEast   
	&image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
	&dy=10   
	&dx=10   
示例响应

图片水印示例

多重水印示例
示例请求

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

请求代码

注意:

  • 接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
  • 制作图片水印时,注意加密的水印链接需以"http"开头,否则会返回400错误。
https://ks3-cn-beijing.ksyun.com/ks3-resources/[email protected]@
	tag=imgBaseOp   
	&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错误。
https://ks3-cn-beijing.ksyun.com/ks3-resources/[email protected]@
	tag=imgWaterMark   
	&type=1   
	&dissolve=65   
	&gravity=NorthEast   
	&image=aHR0cDovL2tzMy5rc3l1bi5jb20vY3NzL2ltZy9maXhlZF9rc2NfbG9nby5wbmc=   
	&dy=10   
	&dx=10
	&wtw=500
	&wth=500   
示例响应

图片水印示例

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈