添加水印

参数说明

操作名称：watermark

• 基础参数（水印位置）

  参数	说明	取值范围

  参数	说明	取值范围
  t	指定水印图片或水印文字的透明度。	0 ~ 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种字体，字体及字体编码请参见type参数中可选的文字类型及编码。
  color	指定文字水印的文字颜色，参数值为RGB颜色值。	RGB颜色值，默认值：000000-黑色。
  rotate	指定文字顺时针旋转角度。	0~360，默认值：0-不旋转，单位：度。
  fill	指定是否将文字水印铺满原图。	可选值0或者1，默认值为0。 0：不将文字水印铺满原图。 1：将文字水印铺满原图。
  size	指定文字水印的文字大小。	1 ~ 1000，默认值：40，单位：px。

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

  文字字体	中文含义	编码值

  文字字体	中文含义	编码值
  alihyaihei	阿里汉仪智能黑体，默认字体	YWxpaHlhaWhlaQ
  hysong	汉仪宋体	aHlzb25n
  hyhei	汉仪黑体	aHloZWk
  hyshuangxian	汉仪双线体	aHlzaHVhbmd4aWFu
  fzltzhk	方正兰亭中黑	ZnpsdHpoaw
  fzshengsks	方正盛世楷书	ZnpzaGVuZ3Nrcw
  fzqusongjian	方正趣宋简体	ZnpxdXNvbmdqaWFu
  zzgfxingyan	造字工房星岩	enpnZnhpbmd5YW4
  comfortaa	Comfortaa	Y29tZm9ydGFh
  notosans	NotoSans	bm90b3NhbnM

  说明

  若您使用的字体未在下表的10种字体中，系统将自动切换为默认字体alihyaihei。

水印编码

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

1. 将内容编码成Base64。

   说明

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

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

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

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

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

操作示例

• 仅添加文字水印：

  对文字水印的内容Hello World进行URL安全的Base64位编码。具体操作，请参见水印编码，编码结果为SGVsbG8gV29ybGQ；hysong字体的为编码为aHlzb25n。图片处理URL为：http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n

• 同时添加文字和图片水印：

  • 文字水印内容：新年快乐，进行URL安全的Base64位编码结果为：5paw5bm05b-r5LmQ，水印位置是右下、水平边距10、垂直边距10：g_se,x_10,y_10

  • 图片水印地址：http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png，Base64编码后为aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n。水印图片位于原图的左上方、水平边距10、垂直边距10：g_nw,x_10,y_10

  • 图片处理URL：http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10