质量变换
简介
imageMogr2 提供一系列高级图片处理功能,本文介绍 图片质量变换,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价。
限制说明
- 原图限制
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
、heif
(webp动图,仅支持持久化处理)
- 原图格式支持:
- 输出限制
- 如果您有多张多帧 gif 图片需要处理,可在图片上传完成后异步进行预转,这样不必在初次访问时进行图片处理,访问速度更快。建议优先使用持久化处理
- 同步处理
- 同步处理只支持 20MB 以内的图片,超过 20MB 的图片需要使用持久化处理
- 同步处理前的gif最大帧数为 200
- 同步处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 同步处理后的图片
w
和h
参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
- 持久化处理
- 持久化处理无大小限制
- 持久化处理前的
gif
、webp动图
,最大帧数为 500 - 持久化处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 持久化处理后的图片
w
和h
参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素
参数说明
注意:接口规格不含任何空格与换行符。
imageMogr2/quality/<Quality>
/size-limit/<sizeLimit>
/ignore-error/<ignoreError>
参数说明
参数名称 | 必填 | 说明 |
---|---|---|
/quality/<Quality> |
新图的图片质量 ● 取值范围是[1, 100] ● 输入是 jpeg ,且不强制指定质量条件下,七牛会根据原图质量算出一个修正值,取修正值和指定值中的小值。注意: ● 指定值后面可以增加 ! ,表示强制使用指定值,如100! 。● heic:默认值35 ● avif:默认值50 ● 其他格式:默认值75 |
|
size-limit/<sizeLimit> |
限制图片转换后的大小,支持以兆字节和千字节为单位的图片。 1.仅对于jpg格式的图片,可以用于限制图片转换后的大小,支持魔法变量$(fsize)表示原图大小。如: http://developer.qiniu.com/resource/Ship.jpg?imageMogr2/size-limit/$(fsize) 。
|
|
/ignore-error/<ignoreError> |
可选 取值: 1 ● 未设置此参数时,正常返回处理结果。 ● 设置了此参数时,若图像处理的结果失败,则返回原图。 ● 设置了此参数时,若图像处理的结果成功,则正常返回处理结果。 |
<Quality>
修正值算法:
- 原图 quality <= 90: min[90, 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)]
- 原图 quality > 90: 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)
示例
-
原图
-
设置图片质量为55:
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/quality/55
操作方式
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)