跳到正文
控制台

图片水印

以下示例的原图均为:https://demo.bitiful.com/bridge.jpeg

图片水印只作用于静态图片。动图(GIF、动态 WebP、APNG 等)会原样输出,不加水印。

参数说明

水印图源

支持的格式:SVG / JPEG / PNG / WebP / AVIF / HEIC / BMP

  • 水印图只能是同一个桶内的图片。
  • 需要半透明或异形水印时,使用带透明通道的 PNG、WebP、AVIF,或直接使用 SVG。
  • SVG 水印按目标尺寸矢量渲染,放大后依然清晰(2025 年 7 月起支持)。

参数总览

参数说明默认值取值
mark水印图片路径,即桶内 path(如 img/logo.png)。为空则不加水印;建议 UrlEncode空同桶内的图片
mark-pos水印位置,格式 x,y,详见下方「位置写法」0.96,0.98–
mark-pct最大占比。水印超过「图片宽高 × 该值」时等比缩小;大于 1 表示允许超出图片。可写 x,y 分别约束宽、高0.25大于 0,至多 5
mark-alpha不透明度,0 为全透明,1 为不透明10 ~ 1
mark-blend混合模式normalnormal / multiply / screen / overlay / darken / lighten / soft-light / hard-light / difference / add / subtract
mark-tile平铺,设为 1 时铺满整张图,隔行错位关闭1
mark-tile-gap平铺间距,格式 横,纵;百分比按水印自身宽高计算50%像素或百分比
mark-tile-rot平铺倾斜角度0-90 ~ 90
mark-if-min-width
mark-if-min-height
尺寸门槛。图片宽或高小于该值时不加水印,避免缩略图被水印遮挡不限像素
mark-hdr-rateHDR 亮度增益(与文字水印共用),仅对带增益图的 HDR 输出生效。0 为不提亮,1 为最亮0.50 ~ 1,或 0% ~ 100%

mark-pct 对位图水印是上限:水印只会缩小,不会放大。对 SVG 水印是目标尺寸:水印会按该比例渲染。

位置写法

mark-pos 的 x、y 各自独立,可以混用不同写法;只写一个值时两个方向取相同值。位置按处理后的图片(缩放、裁剪之后)计算。

比例值(小于 1) 有三种定位基准:

写法定位基准效果
0.5在「水印完整留在图内」的范围里按比例取位:0 贴左 / 上边,越接近 1 越靠右 / 下边水印始终完整显示
*0.5水印中心落在图片的该比例处靠近边缘时最多有一半超出图片
**0.5水印左 / 上边缘落在图片的该比例处靠近右 / 下边缘时可完全移出图片

绝对值(大于等于 1):水印左上角相对图片左上角的像素偏移。

建议为 mark-pos 设定小于 1 的比例值。原图的尺寸与比例各不相同(尤其是配合 w、h 缩放裁剪之后),比例值能让水印的位置在不同图片上保持一致。

参数示例

将桶内的 Logo 置于图片底部居中:

URL:https://demo.bitiful.com/bridge.jpeg? mark=static/img/bitiful-logo@3x.png & mark-pos=0.5,0.95

图片水印:底部居中