智能多媒体服务

  • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理(imageMogr2) >格式转换

    格式转换

    最近更新时间: 2024-05-10 17:51:03

    简介

    imageMogr2 提供一系列高级图片处理功能,本文介绍 图片格式转换、gif 颜色控制,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价

    限制说明

    • 原图格式支持: psdjpegpnggifwebptiffbmpavifheic
    • 同步处理
      • 原图只支持 20MB 以内的图片,超过 20MB请使用持久化处理
      • 处理前的 gif ,最大帧数为 200
      • 处理前的图片 wh不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后的图片wh 不能超过9999像素,总像素不得超过2500w 像素
        • 输出为 avif 时,图片总像素不能超过768w像素
        • 输出为 webp 时,图片 wh 不能超过16383像素
    • 持久化处理
      • 原图无大小限制
      • 处理前的gifwebp动图,最大帧数为 500
      • 处理前的图片 wh 不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后的图片 wh 不能超过14999像素,总像素不得超过6000w像素
        • 输出为 heicavif 时,图片wh 不能超过9999像素,总像素不能超过3072w像素
        • 输出为 webp 时,图片 wh 不能超过16383像素

    参数说明

    注意:接口规格不含任何空格与换行符。

    imageMogr2/format/<Format>
              /colors/<colors>
              /ignore-error/<ignoreError>
    

    参数说明

    参数名称 必填 说明
    /format/<Format> 图片输出格式
    1、取值:copy,保持原图格式输出。
    2、取值:jpggifpngwebp等,参考支持转换的图片格式
    3、取值:heicavif ,属于 图片高级压缩 格式,按照图片高级压缩收费。
    注意
    ● 当原图为heicavif 时,设置format/copy 会保持原图格式不变,且不按照图片高级压缩收费;如果不指定 format 参数,将会输出jpeg
    /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 等时,透明区域填充白色。

    示例

    • 原图

      img

    • 转为gif格式:

      https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/gif
      

      img

    操作方式

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

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