添加水印

注意事项

• 支持同时添加多个水印，且支持同时添加图片水印和文字水印，最多支持添加5个。

• 图片水印暂不支持缩放，水印图片原图不能超过1 MB。

参数说明

操作名称：watermark

• 基础参数（水印位置）

  参数	说明	取值范围
  t	指定水印图片或水印文字的透明度。	[0,100] 默认值为100， 表示透明度100%（即不透明）。
  g	指定水印在图片中的位置。	nw：左上 north：中上 ne：右上 west：左中 center：中部 east：右中 sw：左下 south：中下 se：右下 详情请参见上方基准点图片。
  x	指定水印的水平边距， 即距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。	[0,4096] 默认值为10 ，单位：px（像素）。
  y	指定水印的垂直边距，即距离图片边缘的垂直距离。 这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。	[0,4096] 默认值为10， 单位：px（像素）。

水平边距、垂直边距、中线垂直偏移不仅可以调节水印在图片中的位置，当图片存在多重水印时，还可以调节水印在图中的布局。

• 图片水印参数

  参数	说明	取值范围
  image	指定可以访问的图片水印地址，水印地址可以公开访问，若有鉴权或权限设置，可能导致获取水印地址失败。 水印地址需进行Base64编码。详细信息，请参见水印编码。	Base64编码后的字符串。

• 文字水印参数

  参数	说明	取值范围
  text	指定文字水印的文字内容，文字内容需进行Base64编码。详细信息，请参见水印编码。	Base64编码后的字符串，最大长度不能超过60个字符。
  type	指定文字水印的字体，字体名称需进行Base64编码。详细信息，请参见水印编码。	共支持10种文字字体，字体及字体编码请参见文字类型编码对应表。 说明 如果您使用的是10种字体之外的其他字体，系统会识别出您使用的是默认字体alihyaihei。
  color	指定文字水印的文字颜色，参数值为RGB颜色值。	RGB颜色值，例如：000000表示黑色，FFFFFF表示白色。 默认值：000000（黑色）。
  rotate	指定文字顺时针旋转角度。	[0,360] 默认值：0，表示不旋转。
  fill	指定是否将文字水印铺满原图。	[0,1]，默认值为0。 0：表示不将文字水印铺满原图。 1：表示将文字水印铺满原图。
  size	指定文字水印的文字大小。	(0,1000] 默认值：40 单位：px

  type参数中可选的文字类型及编码如下表所示。

  文字字体	中文含义	编码值
  alihyaihei	阿里汉仪智能黑体，默认字体	YWxpaHlhaWhlaQ
  hysong	汉仪宋体	aHlzb25n
  hyhei	汉仪黑体	aHloZWk
  hyshuangxian	汉仪双线体	aHlzaHVhbmd4aWFu
  comfortaa	Comfortaa	Y29tZm9ydGFh
  notosans	NotoSans	bm90b3NhbnM

水印编码

添加水印时，文字水印的文字内容、文字字体和图片水印的水印地址需进行URL安全的Base64编码。编码方式如下：

1. 将内容编码成Base64。

   推荐使用URL-safe Base64编码工具对文字水印的文字内容、文字字体和图片水印的水印地址进行编码。水印编码后的内容仅适合应用在水印操作的特定参数中，请勿将其用在签名字符串（Signature）的内容里。

2. 替换编码结果中的部分编码。

   • 将结果中的加号（+）替换成短划线（-）。

   • 将结果中的正斜线（/）替换成下划线（_）。

   • 将结果中尾部的等号（=）省略。