最近更新时间:2026-03-31 13:51:03
通过resize操作能够使图片按照一定规则进行缩小或放大,支持按照指定宽高和比例进行缩放。
限制 | 项目 | 说明 |
原图限制 | 图片格式 | 原图支持 JPG, PNG, WEBP, BMP, GIF, TIFF, HEIC, WBMP, PPM, MNG, AVIF, DNG, PIC, SVG |
图片大小 | 不超过 20MB | |
图片宽高 | 像素数不超过 2.5亿。
| |
图片帧数 | 不超过 200帧 | |
结果图限制 | 图片缩放 | 宽高均不超过 4096像素 |
操作名称:resize
具体参数说明如下表所示。
参数 | 取值说明 | 代码样例 |
m | 设置缩略的类型。取值为lfit、mfit、fill、pad和fixed,默认值为lfit。 lfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形内最大的图片。 mfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形延伸区域的最小图片。 fill:指定一个w和h的矩形,将图片进行等比缩放,取在延伸区域的最小图片,并进行居中裁剪。即将mfit缩略类型的图片进行居中剪裁。 pad:指定一个w和h的矩形,将图片进行等比缩放,居中取在矩形内最大的图片,并在矩形空白处进行颜色填充。即lfit缩略类型的图片在矩形空白处进行颜色填充。 fixed:强制按照固定的宽高进行缩略。 ratio:指定一个w和h的目标比例,取原图内满足目标比例的最大的图片,强制缩放。
| image/resize,m_lfit,h_100,w_100 |
p | 等比例缩放的倍数百分比。取值范围为[1,1000]。当取值为: <100:缩小。 =100:保持原图大小。 >100:放大。 | image/resize,p_50 |
h | 目标缩略图的高度。取值为[1,4096],且输出总像素数不超过 2.5亿。 | image/resize,m_lfit,h_100 |
w | 目标缩略图的宽度。取值为[1,4096],且输出总像素数不超过 2.5亿。 | image/resize,m_fixed,h_100,w_100 |
l | 指定目标缩略图的最长边。取值为[1, 4096],且输出总像素数不超过 2.5亿。 长边为指定的值,短边按照比例缩放。
| image/resize,l_100 |
s | 指定目标缩略图的最短边。取值为[1, 4096],且输出总像素数不超过 2.5亿。 短边为指定的值,长边按照比例缩放。 | image/resize,s_100 |
color | 填充的颜色。选择pad(缩略后填充)模式时可以使用。 格式为十六进制颜色码,取值为000000到FFFFFF,默认值为白色。 | image/resize,m_pad,h_100,w_100,color_FF0000 |
limit | 是否在目标缩略图比原图大时进行限制放大。取值为0或1,默认值为1。 0:不进行限制。 1:进行限制。
| image/resize,p_150,limit_0 |
说明:
1. 只有未指定参数 w h l s 时,参数 p 才有效。
2. 使用参数 p 进行等比缩放时参数 limit 和 m 无效。
3. 若缩放时只指定宽度、高度、长边、短边其中一个:
缩放模式为lfit,mfit,fixed时,会按比例缩放图片。例如原图为256px*144 px,将高缩放为100 px,则宽缩放为178px。
缩放模式为pad,fill时,会将原图宽高均按照指定值进行缩放。例如原图为256px*144px,将高缩放为100 px,则宽也缩放为100 px。
指定高为100,宽度按比例处理(默认为lfit)。
等比缩放,按短边将图片样式缩略为100*100。
指定长边为100,短边按照比例缩放。
https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,l_100
固定宽高,居中自动裁剪,将图片样式缩略为100*100。
强制将缩略图的宽和高固定为100。
固定宽高,按短边将图片样式缩略为100*100,填充白色。
固定宽高,按短边将图片样式缩略为100*100,填充红色。
等比例放大150%,调用参数“limit_0”取到放大图片。
调用p参数将图等比例缩小为30%。
https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,p_30
指定宽高比例,将原图宽高比例缩放至3:2。
纯净模式
