最近更新时间:2023-01-04 10:04:51
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的域名}/object@base@
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 |
rotate | 否 | 水印文字旋转角度,[-180, 180], 默认为0 |
tile | 否 | 指定是否将文字水印铺满原图, 1:表示将文字水印铺满原图, 0(默认值):表示不将文字水印铺满全图 |
uw | 否 | 水印文字填充单元宽度,默认值为1 |
uh | 否 | 水印文字填充单元高度,默认值为1 |
NorthWest | North | NorthEast |
West | Center | East |
SouthWest | South | SouthEast |
该请求不需要设置特殊的头部。
注意:接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
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
参数名称 | 必填 | 解释说明 |
---|---|---|
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 | 服务端操作失败。 |
一些关于水印功能的简单示例
注意:接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
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
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png
注意:
- 接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
- 制作图片水印时,注意加密的水印链接需以"http"开头,否则会返回400错误。
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
多重水印,包括对同一张图片可以执行两种或多种操作(基本图片操作和图片水印),两种操作直接用"|"间隔就OK了。
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png
注意:
- 接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
- 制作图片水印时,注意加密的水印链接需以"http"开头,否则会返回400错误。
https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@
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://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/fixed_ksc_logo.png
注意:
- 接口格式不含任何空格与换行符,以下内容为了方便阅读做了格式化。
- 制作图片水印时,注意加密的水印链接需以"http"开头,否则会返回400错误。
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
纯净模式