文档中心

对象存储

请输入

图片处理

图片水印

图片水印功能（watermark）可以为 TOS 存储桶内的图片添加文字水印、图片水印以及图文水印。本文介绍水印功能相关的参数说明及使用示例。

约束限制

文字水印功能暂时不支持繁体中文。

水印图格式/大小限制参考图片处理概述中的原图使用限制。

使用图片水印功能后，原图和水印图都会转换成静态图。

当前不支持使用 SSE-C 加密的水印图添加图片水印。

基础参数

基础参数为文字水印和图片水印均可使用的参数，具体参数如下所示。

参数	参数说明	取值说明	是否必须
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	否
voffset	水印的中线垂直偏移。当水印位置在左中、中部、右中时，可以指定水印位置根据中线往上或者往下偏移。	取值范围：[-1000,1000] 默认值：0 单位：px	否

图片水印

图片水印参数可以指定水印图片以及水印图片的预处理参数，具体参数如下所示。

说明

例如使用 watermark.jpg 作为水印图片，经过 url 安全的 base64 编码处理之后，图片水印的最终参数为 image/watermark,image_d2F0ZXJtYXJrLmpwZw。

参数	参数说明	取值说明	是否必须
image	水印图片的对象名称，需要进行 url 安全的 base64 编码，且必须与目标图片位于同一个存储桶内。	base64 编码的字符串。	添加水印图片时必须
P	指定图片水印按照待添加水印的原图的比例进行缩放。该参数为 resize 功能特殊参数，只能在水印图片预处理过程中使用。	取值为缩放的百分比。例如：参数值为 10，如果原图为 100×100，则图片水印大小为 10×10；当原图变成 200×200，则图片水印大小为 20×20。	否
其他预处理操作	对水印图片进行预处理。	图片缩放、自定义裁剪、索引切割、以及图片旋转操作中的所有功能对水印图片进行预处理。	否

注意

水印图片预处理参数是 image 的参数值，也需要进行 base64 编码，例如使用 watermark.jpg 作为水印图片，并对其进行 30% 的缩放预处理，原始参数为 image_watermark.jpg?x-tos-process=image/resize,P_30，url 安全的 base64 编码之后为 image_d2F0ZXJtYXJrLmpwZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxQXzMw。

文字水印

文字水印参数可以指定文字内容、文字大小、文字类型以及文字颜色等，具体参数如下所示。

说明

使用 "Hello world" 作为水印文字，字体选择方正书宋，顺时针旋转 45 度，原始参数为 text_Hello world,type_fangzhengshusong,rotate_45，文字内容以及字体经过 url 安全的 base64 编码之后为参数为text_SGVsbG8gd29ybGQ,type_ZmFuZ3poZW5nc2h1c29uZw,rotate_45。

参数	参数说明	取值说明	是否必须
text	文字水印内容，需要进行 url 安全的 base64 编码。	编码之前中文字符串的最大字节长度为 64 个字符。	添加文字水印时必须
type	文字水印的字体，需要进行 url 安全的 base64 编码。	可选字体为文泉驿正黑（默认）、文泉微米黑、方正书宋、方正楷体、方正黑体、方正仿宋、DroidSansFallback，字体的具体编码，请参见下表。	否
color	文字水印的颜色。	十六进制颜色码，取值为 000000 到 FFFFFF，默认值为000000（黑色）。	否
size	文字水印的文字大小。	取值范围：(0,1000] 默认值：40 单位：px	否
shadow	文字水印的阴影透明度。	取值范围：[0,100] 默认值：0，表示没有阴影。	否
rotate	文字水印按顺时针方向旋转的角度。	取值范围：[0,360] 默认值：0，表示不旋转。	否
fill	是否将水印文字平铺满原图。	1：表示将文字水印铺满原图。 0（默认值）：表示不将文字水印铺满全图。	否

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

原始参数	url 安全的 base64 编码	字体名称	备注
wqy-zenhei	d3F5LXplbmhlaQ	文泉驿正黑	已省略填充符=
wqy-microhei	d3F5LW1pY3JvaGVp	文泉微米黑	无
fangzhengshusong	ZmFuZ3poZW5nc2h1c29uZw	方正书宋	可省略填充符=
fangzhengkaiti	ZmFuZ3poZW5na2FpdGk	方正楷体	可省略填充符=
fangzhengheiti	ZmFuZ3poZW5naGVpdGk	方正黑体	可省略填充符=
fangzhengfangsong	ZmFuZ3poZW5nZmFuZ3Nvbmc	方正仿宋	可省略填充符=
droidsansfallback	ZHJvaWRzYW5zZmFsbGJhY2s	DroidSansFallback	可省略填充符=

图文混合水印

在一个水印功能中同时指定图片和文字水印，通过图文混合水印参数可以调整图片和文字的排列关系，具体参数如下所示。

参数	参数说明	取值说明	是否必须
order	文字水印和图片水印的前后顺序。	0（默认值）：表示图片水印在前。 1：表示文字水印在前。	否
align	文字水印和图片水印的对齐方式。	0：表示文字水印和图片水印上对齐。 1：表示文字水印和图片水印中对齐。 2（默认值）：表示文字水印和图片水印下对齐。	否
interval	文字水印和图片水印间的间距。	取值范围：[0,1000] 默认值：0 单位：px	否

示例

说明

图片和文字水印参数均需要进行 base64 编码，您可以使用URL-safe Baes64编码工具，完成图片和文字水印参数的 base64 编码。

文字水印示例

添加文字水印，文字内容为 Hello，文字大小设置为 72，颜色设置为红色，字体设置为方正书宋。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw

添加文字水印，水印位置居中，文字顺时针旋转 45 度，其他参数同上。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45

添加文字水印，平铺原图，其他参数同上。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45,fill_1

图片水印示例

水印原图：https://tos-tools.tos-cn-beijing.volces.com/misc/watermark1.png

原图等比缩放 60%，直接添加图片水印，水印等比缩放10%，misc/watermark1.png?x-tos-process=image/resize,p_10 编码为 bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw

添加图片水印，水印位置居中，顺时针旋转 45 度，其他参数同上。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,g_center,rotate_45

图文混合水印

说明

该处图文混合水印是指在一个 watermark 功能中同时指定文字和图片水印，您可以通过图文混合水印参数调整文字和图片的排布方式。

图文混合水印，默认参数。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8

图文混合水印，文字在左，图片在右，中线对齐，文字、图片间隔 100。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8,align_1,order_1,interval_100

添加多个图片和文字水印

添加两个图片水印 watermark1.png 和 watermark2.png，以及两个文字水印“Hello World”和“你好”，水印说明如下：

原图等比缩放 60%。

“Hello World”文字大小 60，字体为方正书宋，位置右上角，颜色黑色 000000。

“你好”文字大小 50，字体为方正楷体，位置居中，颜色红色 FF0000。

watermark1.png，等比缩放 5%，位置左下角，透明度 60，misc/watermark1.png?x-tos-process=image/resize,p_5 编码为 bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=。

watermark2.png 图片，等比缩放 5%，位置位于右下角，misc/watermark2.png?x-tos-process=image/resize,p_5 编码为 bWlzYy93YXRlcm1hcmsyLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_sw/watermark,image_bWlzYy93YXRlcm1hcmsyLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_se/watermark,text_SGVsbG8gV29ybGQ,g_ne,size_60,type_ZmFuZ3poZW5nc2h1c29uZw/watermark,text_5L2g5aW9,g_center,size_50,type_ZmFuZ3poZW5na2FpdGk,color_FF0000

最近更新时间：2026.08.10 16:16:01

这个页面对您有帮助吗？

有用

无用