注意事項

• 支持同時添加多個水印，且支持同時添加圖片水印和文字水印，最多支持添加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. 替換編碼結果中的部分編碼。

   • 將結果中的加號（+）替換成短劃線（-）。

   • 將結果中的正斜線（/）替換成下劃線（_）。

   • 將結果中尾部的等號（=）省略。