全部文档
当前文档
最近更新时间：2026-04-02 21:18:54
操作名称：watermark
相关参数如下：
基础参数
参数 | 是否必须 | 描述 | 取值范围 |
t | 否 | 指定图片水印或水印文字的透明度。 | [0,100] 默认值：100， 表示透明度100%（不透明）。 |
g | 否 | 指定水印在图片中的位置。 |
详情请参见下方基准点图片。 |
x | 否 | 指定水印的水平边距。 当水印位置是左上、左中、左下时，表示水印左边距离图片左边的距离； 当水印位置是右上、右中、右下时，表示水印右边距离图片右边的距离； 当水印位置是中上、中部、中下时，表示水印垂直中线距离图片垂直中线的距离。 | [0,4096] 默认值：10 单位：像素（px） |
y | 否 | 指定水印的垂直边距； 当水印位置是左上、中上、右上，表示水印上边距离图片上边的距离； 当水印位置是左下、中下、右下，表示水印下边距离图片下边的距离； 当水印位置时中上、中部、中下时，表示水印水平中线距离图片水平中线的距离。 | [0,4096] 默认值：10 单位：像素（px） |
fill | 否 | 指定是否将图片水印或文字水印铺满原图。 |
|
padx | 否 | 水印平铺时单个水印间的水平间隔。仅在水印平铺开启时有效。 | [0,4096] 默认值：0 单位：像素（px） |
pady | 否 | 水印平铺时单个水印间的垂直间隔。仅在水印平铺开启时有效。 | [0,4096] 默认值：0 单位：像素（px） |
图片水印参数
参数 | 是否必须 | 描述 | 取值范围 |
image | 是 | 用于指定作为图片水印的完整URL，需进行Base64编码。详情请参见水印编码。 | Base64编码后的字符串。 |
文字水印参数
参数 | 是否必须 | 描述 | 取值范围 |
text | 是 | 指定文字水印的文字内容，文字内容需进行Base64编码。详情请参见水印编码。 | Base64编码之前中文字符串的最大字节长度为64个字符。 |
type | 否 | 指定文字水印的字体，字体名称需进行Base64编码。 | 支持的字体及字体编码详情请参见文字类型编码对应表。 默认值：wqy-zenhei（ 编码后的值为d3F5LXplbmhlaQ） |
color | 否 | 指定文字水印的文字颜色，参数值为RGB颜色值。 | RGB颜色值，例如：000000表示黑色，FFFFFF表示白色。 默认值：000000（黑色） |
size | 否 | 指定文字水印的文字大小。 | (0,1000] 默认值：40 单位：px |
rotate | 否 | 指定文字顺时针旋转角度。 | [0,360] 默认值：0，表示不旋转。 |
type参数中可选的文字类型及编码如下表所示。
字体参数值 | Base64编码值 |
黑体 | 6buR5L2T |
宋体 | 5a6L5L2T |
楷体 | 5qW35L2T |
微软雅黑 | 5b6u6L2v6ZuF6buR |
仿宋 | 5Lu/5a6L |
Times-Roman | VGltZXMtUm9tYW4 |
Times-Bold | VGltZXMtQm9sZA |
Times-Italic | VGltZXMtSXRhbGlj |
Times-BoldItalic | VGltZXMtQm9sZEl0YWxpYw |
Helvetica | SGVsdmV0aWNh |
Helvetica-Bold | SGVsdmV0aWNhLUJvbGQ |
Helvetica-Oblique | SGVsdmV0aWNhLU9ibGlxdWU |
Helvetica-BoldOblique | SGVsdmV0aWNhLUJvbGRPYmxpcXVl |
Courier | Q291cmllcg |
Courier-Bold | Q291cmllci1Cb2xk |
Courier-Oblique | Q291cmllci1PYmxpcXVl |
Courier-BoldOblique | Q291cmllci1Cb2xkT2JsaXF1ZQ |
Palatino-Roman | UGFsYXRpbm8tUm9tYW4 |
Palatino-Italic | UGFsYXRpbm8tSXRhbGlj |
Palatino-Bold | UGFsYXRpbm8tQm9sZA |
Palatino-BoldItalic | UGFsYXRpbm8tQm9sZEl0YWxpYw |
图文混合水印参数
参数 | 是否必须 | 描述 | 取值范围 |
order | 否 | 指定文字和图片水印的前后顺序。 | 0、1
|
align | 否 | 指定文字水印和图片水印的对齐方式。 | 0、1、2
|
interval | 否 | 指定文字水印和图片水印间的间距。 | [0,1000] 默认值：0 单位：px |
在添加水印操作中，文字水印的文字内容、文字字体、图片水印的水印图片名称等参数需要进行URL安全的Base64编码。编码步骤如下：
将内容编码成Base64。
将结果中的部分编码替换。
将结果中的加号（+）替换成短划线（-）。
将结果中的正斜线（/）替换成下划线（_）。
将结果中尾部的所有等号（=）省略。
推荐通过base64url encoder对文字水印的文字内容、文字颜色、文字字体、图片水印的水印图片名称等参数进行编码。
纯净模式
