针对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信息。 |
批量处理图片时,建议使用图片样式。详情请参见图片样式。
操作方式
您可以通过文件URL、API、SDK对图片进行处理。操作方式,请参见图片处理操作方式。
使用限制
使用图片处理服务时有如下限制:
- 原图限制
- 图片格式只支持JPG、PNG、BMP、GIF、WebP、TIFF。
- 原图大小不能超过20 MB。
- 除图片旋转对应的原图高或者宽不能超过4,096 px外,其他图片操作对应的原图高或者宽不能超过30,000 px,且总像素不能超过2.5亿 px。
动态图片(例如GIF图片)的像素计算方式为
宽*高*图片帧数
;非动态图片(例如PNG图片)的像素计算方式为宽*高
。
- 缩放后图片限制
宽或高不能超过16,384 px,且总像素不能超过16,777,216 px。
- 样式限制
每个存储空间下最多能创建50个样式。如您的业务有更多样式的需求,请联系技术支持。
费用说明
版本说明
图片处理服务目前提供新版和旧版两个版本的API接口,本文档介绍新版接口的使用,旧版接口的功能今后不再更新。有关新旧版本接口使用兼容性的详细说明,请参见新旧版本图片处理服务及使用说明。