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

处理参数

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

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

图片处理参数说明
图片缩放resize将图片缩放至指定大小。
图片水印watermark为图片添加图片或文字水印。
自定义裁剪crop裁剪指定大小的矩形图片。
质量变换quality调整JPG和WebP格式图片的质量。
格式转换format转换图片格式。
获取信息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://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、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个样式。如您的业务有更多样式的需求，请提交工单申请。

费用说明

使用图片处理服务时，会产生如下费用：
  • 请求费用

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

  • 流量费用

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

版本说明

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