针对OSS内存储的图片文件(Object),您可以在GetObject请求中携带图片处理参数对图片文件进行处理。例如添加图片水印、转换格式等。

操作视频

观看以下视频了解如何快速处理图片:

处理参数

OSS支持直接使用一个或多个参数处理图片,也支持将多个参数封装在一个样式中批量处理图片。有关图片样式的详情,请参见图片样式

当存在多个图片处理参数时,OSS将按照参数顺序对图片进行处理。图片处理参数如下:

图片处理 参数 说明
图片高级压缩 format 将图片转换为HEIF或WebP M6等高压缩比格式。
图片缩放 resize 将图片缩放至指定大小。
内切圆 circle 以图片中心点为圆心,裁剪出指定大小的圆形图片。
自定义裁剪 crop 裁剪指定大小的矩形图片。
索引切割 indexcrop 按指定x或y轴的大小切分图片,之后选取其中一张图片。
圆角矩形 rounded-corners 按指定圆角大小将图片裁剪成圆角矩形。
自适应方向 auto-orient 将携带旋转参数的图片进行自适应旋转。
旋转 rotate 按指定角度以顺时针方向旋转图片。
模糊效果 blur 对图片进行模糊处理。
亮度 bright 调整图片亮度。
锐化 sharpen 对图片进行锐化处理。
对比度 contrast 调整图片对比度。
渐进显示 interlace 将JPG格式的图片调整为渐进显示。
质量变换 quality 调整JPG和WebP格式图片的质量。
格式转换 format 转换图片格式。
图片水印 watermark 为图片添加图片或文字水印。
获取图片主色调 average-hue 获取图片主色调。
获取信息 info 获取图片信息,包括基本信息、EXIF信息。
例如,对原图example.jpg添加图片缩放resize以及质量变换quality参数后,文件URL为https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300/quality,q_90。您可以通过配置不同的规则,实现CDN回源原图或者经图片处理参数后的图片。
  • 回源原图

    通过CDN开启过滤参数后,文件URL请求中问号(?)之后的参数将全部去除,即直接命中原图example.jpg

  • 回源处理后的图片

    通过CDN开启保留回源参数后,文件URL请求中问号(?)之后的所有参数将全部保留,即直接命中经图片处理参数后的图片。

有关CDN回源规则的配置详情,请参见开启过滤参数及配置保留参数

操作方式

您可以通过文件URL、API、SDK对图片进行处理。操作方式,请参见图片处理操作方式

使用限制

使用图片处理服务时有如下限制:
  • 原图限制
    • 图片格式只支持JPG、PNG、BMP、GIF、WebP、TIFF。
    • 原图大小不能超过20 MB。
    • 除图片旋转对应的原图高或者宽不能超过4,096 px外,其他图片操作对应的原图高或者宽不能超过30,000 px,且总像素不能超过2.5亿 px。

      动态图片(例如GIF图片)的像素计算方式为宽*高*图片帧数;非动态图片(例如PNG图片)的像素计算方式为宽*高

  • 动态图片限制

    仅支持对动态图片(例如GIF格式图片)进行缩放、裁剪、旋转以及添加图片水印的操作。

  • 缩放后图片限制

    宽或高不能超过16,384 px,且总像素不能超过16,777,216 px。

  • 样式限制

    每个存储空间下最多能创建50个样式。如您的业务有更多样式的需求,请联系技术支持

费用说明

使用图片处理服务时,会产生如下费用:
  • 图片处理费用

    未超出免费额度时,不产生费用;超出免费额度后,按处理的原图实际大小计费。计费详情,请参见数据处理费用

  • 请求费用

    处理图片时会产生一次GetObject请求,按请求次数收费。计费详情,请参见请求费用

  • 流量费用

    根据处理的原图大小收取外网流出流量费用。计费详情,请参见流量费用

版本说明

图片处理服务目前提供新版和旧版两个版本的API接口,本文档介绍新版接口的使用,旧版接口的功能今后不再更新。有关新旧版本接口使用兼容性的详细说明,请参见新旧版本图片处理服务及使用说明