图片处理

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

操作视频

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

处理参数

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

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

图片处理

参数

说明

图片缩放

resize

将图片缩放至指定大小。

图片水印

watermark

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

自定义裁剪

crop

裁剪指定大小的矩形图片。

质量变换

quality

调整JPG和WebP格式图片的质量。

格式转换

format

转换图片格式。

HEIF或AVIF图片高级压缩

format

将图片转换为HEIF或AVIF高压缩比格式。

获取信息

info

获取图片信息,包括基本信息、EXIF信息。

自适应方向

auto-orient

将携带旋转参数的图片进行自适应旋转。

内切圆

circle

以图片中心点为圆心,裁剪出指定大小的圆形图片。

索引切割

indexcrop

按指定x或y轴的大小切分图片,之后选取其中一张图片。

圆角矩形

rounded-corners

按指定圆角大小将图片裁剪成圆角矩形。

模糊效果

blur

对图片进行模糊处理。

旋转

rotate

按指定角度以顺时针方向旋转图片。

设置图片显示方式

interlace

将JPG格式的图片调整为渐进显示。

获取图片主色调

average-hue

获取图片主色调。

亮度

bright

调整图片亮度。

锐化

sharpen

对图片进行锐化处理。

对比度

contrast

调整图片对比度。

例如,对原图example.jpg添加图片缩放resize以及质量变换quality参数后,文件URL为https://oss-console-img-demo-cn-hangzhou.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、HEIC、AVIF。

  • 动态图片(例如GIF格式图片)仅支持缩放、裁剪、旋转以及添加图片水印的操作,不支持其它图片处理操作。

  • 如果需要对WebP格式的动态图片进行编解码,请提交工单申请。

图片大小

原图大小不能超过20 MB。

图片宽高

除图片旋转对应的原图高或者宽不能超过4,096 px外,其他图片操作对应的原图高或者宽不能超过30,000 px,且总像素不能超过2.5亿 px。

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

图片压缩

缩放后图片,宽或高不能超过16,384 px,且总像素不能超过16,777,216 px。

图片高级压缩

缩放后图片,HEIC图片不能超过4,096 × 4,096 px,AVIF图片不能超过4,096 × 2,304 px。

图片样式

每个存储空间下最多能创建50个样式。如您的业务有更多样式的需求,请提交工单申请。

说明

您可以在一个样式(Style)中包含多个图片处理参数,快速实现复杂的图片处理操作。更多信息,请参见图片样式

处理能力

  • 每秒图片处理量(按原图大小计)

    • 华东1(杭州)、华东2(上海)、华北2(北京)、华北 3(张家口)、华南1(深圳):20 MB/s。

    • 其他地域:2 MB/s。

  • 每秒请求数QPS(Query Per Second)

    • 华东1(杭州)、华东2(上海)、华北2(北京)、华北 3(张家口)、华南1(深圳):50。

    • 其他地域:5。

说明

如有计算量较大场景(如编码WebP/AVIF/HEIF超过1080p分辨率大图或超过上述限制),需要联系技术支持评估实际使用限制。

费用说明

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

  • 图片处理费用

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

  • 请求费用

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

  • 流量费用

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

版本说明

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