智能多媒体服务

    • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理（imageMogr2） >缩放

    缩放

    最近更新时间: 2024-07-19 17:10:50

    简介

    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像素

    参数说明

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

    imageMogr2/thumbnail/!<Scale>p 
          /thumbnail/!<Scale>px
          /thumbnail/!x<Scale>p
          /thumbnail/<Width>x
          /thumbnail/x<Height>
          /thumbnail/<Width>x<Height>
          /thumbnail/!<Width>x<Height>r
          /thumbnail/<Width>x<Height>!
          /thumbnail/<Width>x<Height>>
          /thumbnail/<Width>x<Height><
          /thumbnail/<Area>@
          /ignore-error/<ignoreError>
    参数名称 必填 说明
    /thumbnail/!<Scale>p 基于原图的长宽，按指定百分比缩放。Scale取值范围[1-999]。
    /thumbnail/!<Scale>px 以百分比形式指定目标图片宽度，高度不变。Scale取值范围[1-999]。
    /thumbnail/!x<Scale>p 以百分比形式指定目标图片高度，宽度不变。Scale取值范围[1-999]。
    /thumbnail/<Width>x 指定目标图片宽度，高度等比缩放，Width取值范围[1-9999]。
    /thumbnail/x<Height> 指定目标图片高度，宽度等比缩放，Height取值范围[1-9999]。
    /thumbnail/<Width>x<Height> 等比缩放，比例值为宽缩放比和高缩放比的较小值，Width 和 Height 取值范围[1-9999]。


    注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高
    /thumbnail/!<Width>x<Height>r 等比缩放，比例值为宽缩放比和高缩放比的较大值，Width 和 Height 取值范围[1-9999]。


    注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高
    /thumbnail/<Width>x<Height>! 按指定宽高值强行缩略，可能导致目标图片变形，width和height取值范围[1-9999]。
    /thumbnail/<Width>x<Height>> 等比缩小，比例值为宽缩放比和高缩放比的较小值。如果目标宽和高都大于原图宽和高，则不变，Width 和 Height 取值范围[1-9999]。


    注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高;
    /thumbnail/<Width>x<Height>< 等比放大，比例值为宽缩放比和高缩放比的较小值。如果目标宽(高)小于原图宽(高)，则不变，Width 和 Height 取值范围[1-9999]。


    注意： 宽缩放比：目标宽/原图宽 高缩放比：目标高/原图高;
    /thumbnail/<Area>@ 按原图高宽比例等比缩放，缩放后的总像素不超过指定值，Area取值范围[1-24999999]。
    /ignore-error/<ignoreError> 主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；
    不设置此参数，默认处理失败时返回错误信息。

    示例

    1. 生成 480x320 缩略图

    等比缩小 75%：

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!75p

    img

    按原宽度 75% 等比缩小：

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!75px

    img

    按原高度 75% 等比缩小：

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!x75p

    img

    2. 生成 700x467 放大图

    指定新宽度为 700px：

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/700x

    img

    指定新高度为 467px：

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/x467

    img

    3. 限定长边，生成不超过 300x300 的缩略图

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/300x300

    img

    4. 限定短边，生成不小于 200x200 的缩略图

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!200x200r

    img

    5. 强制生成 200x300 的缩略图

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x300!

    img

    6. 原图大于指定长宽矩形，按长边自动缩小为 200x133 缩略图

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x300>

    img

    7. 原图小于指定长宽矩形，按长边自动拉伸为 700x467 放大图

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/700x600<

    img

    8. 生成图的像素总数小于指定值

    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/350000@

    img

    操作方式

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

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