智能多媒体服务

    • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理（imageMogr2） >限制图片大小

    限制图片大小

    最近更新时间: 2024-07-19 17:13:01

    简介

    imageMogr2 提供一系列高级图片处理功能，本文介绍 限制图片大小，可限制图片处理（例如缩放、压缩等）后的文件大小，可与 imageMogr2 的其他参数一起使用，详细的计费说明请参见 计费与定价。

    限制说明

    • 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp、avif、heic
    • 输出格式只支持 jpeg
    • 同步处理
      • 原图只支持 20MB 以内的图片
      • 处理前动图帧数限制： gif最大帧数为 200
      • 处理前体积限制：图片 w 和h不能超过3万像素，总像素不能超过1.5亿像素
      • 处理后体积限制：图片w和h 不能超过9999像素，总像素不得超过2500w 像素
    • 持久化处理
      • 原图无大小限制
      • 处理前动图帧数限制：gif、webp动图，最大帧数为 500
      • 处理前体积限制：图片 w和h 不能超过3万像素，总像素不能超过1.5亿像素
      • 处理后体积限制：图片 w和h 不能超过14999像素，总像素不得超过6000w像素

    参数说明

    参数名称 必填 说明
    size-limit/<sizeLimit> 限制图片转换后的大小，支持以兆字节（M）和千字节（K/k）为单位。仅对jpeg输出格式有效。
    1.支持魔法变量$(fsize)表示原图大小，尽量保证不超过原图，不强制。
    如：http://developer.qiniu.com/resource/Ship.jpg?imageMogr2/format/jpeg/size-limit/$(fsize)

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



    注意：大小限制并非绝对的，图片本身质量不同会造成一些误差，建议搭配 strip 参数使用，去除图片的一些冗余信息，会有更准确的限制效果。例如：https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/jpeg/strip/size-limit/15k!

    示例

    • 原图

      img

    • 将 jpg 图片转换为 jpeg 格式，并限制图片大小为15KB，同时与原图进行对比。

      https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/jpeg/size-limit/15k!

      img

    操作方式

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

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