阿里云OSS图片处理服务(Image Processing,简称 IMG) ,是阿里云OSS对外提供的海量、安全、低成本、高可靠的图片处理服务。您可以将原始图片上传保存在OSS上,通过简单的 RESTful 接口,在任何时间、任何地点、任何互联网设备上对图片进行处理。图片处理服务提供图片处理接口,图片上传请使用OSS上传接口。基于IMG,您可以搭建出跟图片相关的服务。

说明

开通OSS服务后,图片服务也随之开通,无需单独开通。

图片服务基础功能

图片处理提供以下功能:

  • 获取图片信息
  • 图片格式转换
  • 图片缩放、裁剪、旋转
  • 图片添加图片、文字、图文混合水印
  • 自定义图片处理样式
  • 通过管道顺序调用多种图片处理功能

历史版本说明

图片处理目前提供两版API接口:新版接口和老版接口。

说明
本文档介绍的是新版接口的功能使用说明,老版接口的功能今后不再更新。使用兼容详细说明,参考新老版本API和域名使用FAQ

快速使用图片服务

新建图片样式
  1. 进入 OSS 管理控制台
  2. 单击您的Bucket名字,进入Bucket 概览 页。
  3. 概览 页中单击 图片处理,然后单击 新建样式
  4. 图片样式 窗口中,新建您需要的图片样式。

    图片样式窗口说明:

    • 规则名称:新建图片样式的名称。命名规则如下:
      • 长度为 1-64 个字符。
      • 只能包含数字、大小写字母、下划线(_)、短横线(-)以及小数点(.)。
    • 编辑类型:可以选择基本编辑,使用图形化的操作来编辑图片样式。也可以选择高级编辑,使用SDK或者处理参数的方式编辑图片样式。
    • 缩略方式:有不使用缩略、等比例缩放和固定宽高缩放三种方式供选择。
      说明
      “长边”是指原尺寸与目标尺寸的比值大的那条边,“短边”同理。例如,原图400x200,缩放为800x100,由于400/800=0.5,200/100=2,0.5 < 2,所以在这个缩放中200那条是长边,400那条是短边。
    • 自适应方向:可以选择是否开启自适应方向。

      建议默认开启,开启后会根据图片中 EXIF 旋转信息先旋转后进行缩略。

    • 保存格式:有原图格式、jpg、png、webp和bmp格式供选择。
    • 图片锐化:设置图片是否需要锐化。
    • 图片质量:有相对质量、绝对质量和不压缩三种方式供选择。
    • 水印:有不使用水印、图片水印和文字水印三种方式供选择。
  5. 编辑好图片样式后单击 确定 保存样式。

图片样式新建好之后您就可以通过OSS将您新建的图片样式应用到您的图片上了。

使用图片样式
  1. 进入 OSS 管理控制台
  2. 单击您的Bucket名称,进入Bucket 概览 页。
  3. 单击 文件管理,选择一张已上传的图片或者上传新图片,然后单击图片名称打开图片 预览 页。

    上传新图片,请参考上传文件

  4. 图片样式 下拉列表中选择一个图片样式。

    在文件预览窗口中即刻看到经过图片处理后的图片效果。带有图片样式的公网访问地址也会同步生成,只需单击 复制文件URL 就可获取到文件访问地址。

视频演示

以下视频详细演示了图片样式处理操作:视频链接