文档

图片处理操作方法

更新时间:

如果有图片自适应WEBP、自动旋转(仅自动调正功能)和自动瘦身需求,可通过控制台直接开启;您也可以通过在请求URL中添加图片处理参数,对图片文件进行更丰富的处理,例如图片裁剪、图片添加水印等。

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

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

开启图像处理

  1. 登录CDN控制台

  2. 在左侧导航栏,单击域名管理

  3. 域名管理页面,找到目标域名,单击操作列的管理

  4. 在指定域名的左侧导航栏,单击性能优化

  5. 图像处理区域框中,打开图像处理开关,选择您需要转换的图片类型。

    说明
    • 选择支持的图片类型后,表示开启图片处理功能。开启图像处理后,通过文件URL处理图片时,URL中携带的图像处理参数才会生效,否则为无效参数。

    • 控制台上是否开启自适应WEBP、图片自动旋转(仅自动调正功能)和图片自动瘦身功能,根据自身业务决定。

    开通图像处理

    参数

    说明

    支持转换的图片类型

    选择您需要转换的图片类型(必选参数,可多选)。

    自适应WEBP

    开启后,通过对请求头Accept进行判断,如果请求头Accept包含image/webp,则CDN会将其他格式图片自动转换为WEBP格式进行缓存。

    说明

    开启该功能后,短时间内会导致命中率下降,过后会自动恢复正常,请勿在业务高峰期开启。

    图片自动旋转

    开启图片自动旋转,可自动调正图片,方便用户查看。

    说明
    • 图片自动旋转只对带有旋转参数auto-orient的图片生效。

    • 开启该功能后,短时间内会导致命中率下降,过后会自动恢复正常,请勿在业务高峰期开启。

    图片自动瘦身

    开启后(默认不开启),在不改变分辨率、尺寸和格式的前提下对图片进行压缩,节省访问流量。

    • 0(默认值):表示不开启。

    • 1~100:表示开启。例如,填写90%表示保留原图质量的90%。

    说明

    仅支持JPEG和WEBP格式。

  6. 单击确定,完成开通。

通过文件URL处理图片

  1. 已选择支持转换的图片类型,请参考开启图像处理

  2. 通过请求URL传参来完成自定义功能。

    • 格式:http://example.com/image_01.png?image_process=action,param_value/action,param_value

      字段

      说明

      example.com

      您的CDN加速域名。

      image_01.png

      图片名称。

      image_process

      image_process为固定参数,标明使用图片处理参数对图片文件进行处理。

      action,param_value

      图片处理的操作(action)、参数(param)和值(value),用于定义图片处理的方式。多个操作以正斜线(/)隔开,CDN将按图片处理参数的顺序处理图片。图片处理支持的参数,请参见图片处理参数

    • 示例:http://example.com/image_01.png?image_process=resize,w_200/rotate,90/format,webp

    • 图片处理效果:图片先按比例缩放至宽200 px,再将图片旋转90°,最终保存为WEBP格式。

支持的图片处理参数

通过在请求URL中添加图片处理参数可实现更丰富的图像处理功能。CDN支持携带一个或多个转换参数处理图片,支持的参数请参见下表。

图片处理功能

处理参数

说明

格式转换

format

转换图片格式。

质量转换

quality

调整图片质量。

图片裁剪

crop

裁剪指定大小的图片。

图片缩放

resize

将图片缩放至指定大小。

图片旋转

  • 图片自动旋转:auto-orient

  • 指定旋转方向:rotate

将携带旋转参数的图片进行自适应旋转或按指定角度以顺时针方向旋转图片。

图片色彩

  • 图片亮度:bright

  • 图片对比度:contrast

  • 图片锐化:sharpen

调整图片的亮度、对比度和清晰度。

添加水印

watermark

为图片添加图片水印或文字水印。

获取信息

info

获取图片信息,包括图片的长、宽、高、图片格式和图片质量等信息。

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