水印管理

更新时间:

添加水印可以用于品牌推广和宣传,还可以帮助保护图片的版权,防止他人未经授权使用图片。CDN支持图片水印和文字水印,可以将水印放在图片的特定位置,并调整水印的透明度,以便在不干扰图片内容的情况下显示水印。

说明
  • 阿里云CDN、DCDN和OSS的图片处理都是独立的功能,不能相互混用。

  • 图像处理为付费服务,公测期间暂不收费,收费时间另行通知。

  • 图像处理功能处于内测阶段,您需提交工单申请开通。

  • 当您使用图像处理功能时,由于不同图片格式在压缩算法上存在较大差异,因此不同图片格式之间相互转换可能会导致图片体积变大,例如:jpeg转webp、jpeg转png、png转webp。如果您需要降低图片文件的体积,建议您通过调整质量参数quality降低图片质量来实现。

注意事项

  • 支持同时添加多个水印,且支持同时添加图片水印和文字水印,最多支持添加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 Baes64编码工具对文字水印的文字内容、文字字体和图片水印的水印地址进行编码。水印编码后的内容仅适合应用在水印操作的特定参数中,请勿将其用在签名字符串(Signature)的内容里。

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

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

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

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

操作示例

  • 添加Hello World的文字水印:

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

  • 添加文字和图片水印:

    • 文字水印内容:Hello World,进行URL安全的Base64位编码结果为:SGVsbG8gV29ybGQ

    • 水印文字位置是右下、水平边距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_SGVsbG8gV29ybGQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10