智能多媒体服务

    • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理（imageMogr2） >质量变换

    质量变换

    最近更新时间: 2023-11-20 10:02:56

    简介

    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)。


    2.对于所有图片格式，若在尾部加上!，表示用转换后的图片大小与原图大小做比较，如果转换后的图片比原图小，则返回转换后的图片，否则返回原图。如：https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/size-limit/15k!。这个主要用于保证返回的图片不会比原图大。


    注意：需要根据图片实际大小设置合理的sizeLimit大小。
    /ignore-error/<ignoreError> 可选
    取值：1
    ● 未设置此参数时，正常返回处理结果。
    ● 设置了此参数时，若图像处理的结果失败，则返回原图。
    ● 设置了此参数时，若图像处理的结果成功，则正常返回处理结果。

    <Quality>修正值算法：

    • 原图 quality <= 90: min[90, 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)]
    • 原图 quality > 90: 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)

    示例

    • 原图

      img

    • 设置图片质量为55：

      https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/quality/55

      img

    操作方式

    您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式，对图片进行处理，详情介绍请参见图片处理操作方式。

    以上内容是否对您有帮助？
    • Qvm free helper
    Close