格式转换
简介
imageMogr2 提供一系列高级图片处理功能,本文介绍 图片格式转换、gif 颜色控制,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价。
限制说明
- 原图限制
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
(webp动图,仅支持持久化处理)
- 原图格式支持:
- 输出限制
- 如果您有多张多帧
gif
图片需要处理,可在图片上传完成后异步进行预转,这样不必在初次访问时进行图片处理,访问速度更快。建议优先使用持久化处理 - 输出为
webp
时,宽或高不能超过16383
- 如果您有多张多帧
- 同步处理
- 同步处理只支持 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/format/<Format>
/colors/<colors>
/ignore-error/<ignoreError>
参数说明
参数名称 | 必填 | 说明 |
---|---|---|
/format/<Format> |
新图的输出格式 取值范围: jpg ,gif ,png ,webp 等,默认为原图格式。 |
|
/colors/<colors> |
1、源图片为 GIF 时,控制输出 GIF 中不同颜色的数量,取值可为2、4、8、16、32、64、128或256,不使用该参数时的默认值为128。2、输出图片为 PNG 时,控制输出 PNG 中不同颜色的数量,取值可为2、4、8、16、32、64、128或256,不使用该参数时默认关闭。 |
|
/ignore-error/<ignoreError> |
可选 取值: 1 ● 未设置此参数时,正常返回处理结果。 ● 设置了此参数时,若图像处理的结果失败,则返回原图。 ● 设置了此参数时,若图像处理的结果成功,则正常返回处理结果。 |
注意:
- 当一张含有透明区域的图片,转换成不支持透明区域的图片格式 jpg、bmp 等时,透明区域填充白色。
示例
-
原图
-
转为gif格式:
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/gif
操作方式
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)