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

处理参数

OSS支持直接使用一个或多个参数处理图片,也支持将多个参数封装在一个样式中批量处理图片。当存在多个图片处理参数时,OSS将按照参数顺序对图片进行处理。图片处理参数如下:

图片处理 参数 说明
图片缩放 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信息。

批量处理图片时,建议使用图片样式。详情请参见图片样式

操作方式

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

使用限制

使用图片处理服务时有如下限制:
  • 原图限制
    • 图片格式只支持JPG、PNG、BMP、GIF、WebP、TIFF。
    • 文件大小不能超过20 MB。
    • 使用旋转图片时原图的宽或高不能超过4096 px。
    • 原图单边大小不能超过30000 px。
    • 原图总像素不能超过2.5亿 px。
  • 缩放后图片限制
    • 宽与高的乘积不能超过4096 px*4096 px。
    • 单边长度不能超过4096 px。
  • 样式限制

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

版本说明

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