文档

水印管理

更新时间:

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

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

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

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

注意事项

  • 支持同时添加多个水印,且支持同时添加图片水印和文字水印,最多支持添加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

    fzltzhk

    方正兰亭中黑

    ZnpsdHpoaw

    fzshengsks

    方正盛世楷书

    ZnpzaGVuZ3Nrcw

    fzqusongjian

    方正趣宋简体

    ZnpxdXNvbmdqaWFu

    zzgfxingyan

    造字工房星岩

    enpnZnhpbmd5YW4

    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

  • 添加文字和图片水印:

    • 文字水印内容:新年快乐,进行URL安全的Base64位编码结果为:5paw5bm05b-r5LmQ

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

  • 本页导读 (1)
文档反馈