human: 如何处理七牛云的智能多媒体服务缩放

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理
>图片高级处理（imageMogr2） >缩放

#  缩放

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

# **简介**

**imageMogr2** 提供一系列高级图片处理功能，本文介绍 **图片缩放功能** ，可与 **imageMogr2**
的其他参数一起使用，详细的计费说明请参见 [计费与定价
__](https://www.qiniu.com/prices/dora?source=dora)。

## **限制说明**

  * 原图格式支持： `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](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!75p)

按原宽度 75% 等比缩小：

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!75px)

按原高度 75% 等比缩小：

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!x75p)

**2.** 生成 700x467 放大图

指定新宽度为 700px：

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/700x)

指定新高度为 467px：

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/x467)

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

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/300x300)

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

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/!200x200r)

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

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x300!)

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

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/200x300)

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

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

![img](https://dora-
doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/700x600%3C)

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

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

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/thumbnail/350000@)

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？