质量变换
简介
imageMogr2 提供一系列高级图片处理功能,本文介绍 图片质量变换,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价。
限制说明
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
、heic
- 同步处理
- 原图只支持 20MB 以内的图片
- 处理前动图帧数限制:
webp动图
最大帧数为50,gif
最大帧数为 200 - 处理前体积限制:图片
w
和h
不能超过3万像素,总像素不能超过1.5亿像素 - 处理后体积限制:图片
w
和h
不能超过9999像素,总像素不得超过2500w 像素。以下情况特别说明:- 输出为
avif
时,图片w
和h
不能超过9999像素,总像素不能超过768w像素 - 输出为
webp静图
时,图片w
和h
不能超过16383像素,总像素不得超过2500w 像素 - 仅限
输入为webp动图格式,输出webp动图/gif动图时
,图片w
和h
不能超过999像素,总像素(宽x高x帧数)不能超过3150万像素
- 输出为
- 持久化处理
- 原图无大小限制
- 处理前动图帧数限制:
gif
、webp动图
,最大帧数为 500 - 处理前体积限制:图片
w
和h
不能超过3万像素,总像素不能超过1.5亿像素 - 处理后体积限制:图片
w
和h
不能超过14999像素,总像素不得超过6000w像素。以下情况特别说明:- 输出为
heic
和avif
时,图片w
和h
不能超过9999像素,总像素不能超过3072w像素 - 输出为
webp动图和静图
时,图片w
和h
不能超过16383像素,总像素不得超过6000w像素
- 输出为
参数说明
参数名称 | 必填 | 说明 |
---|---|---|
/quality/<Quality> |
新图的图片质量 ● 取值范围是[1, 100] ● 输入是 jpeg ,且不强制指定质量条件下,七牛会根据原图质量算出一个修正值,取修正值和指定值中的小值。注意: ● 指定值后面可以增加 ! ,表示强制使用指定值,如100! 。● heic:默认值35 ● avif:默认值50 ● 其他格式:默认值75 |
|
/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中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)