对象存储 OSS：图片缩放

在图片URL末尾添加?x-oss-process=image/resize,p_{percentage}时，OSS会实时处理该图片，并按指定的百分比进行等比例缩小，返回处理后的结果。image/resize表示进行缩放处理，p表示按百分比缩放。p的取值范围为[1, 100]时表示按百分比缩小，p的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,p_50将图片缩小至原尺寸的50%的示例：

在图片URL末尾添加?x-oss-process=image/resize,p_{percentage}时，OSS会实时处理该图片，并按指定的百分比进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，p表示按百分比缩放。p的取值范围为[100, 1000]时，表示按百分比放大。p的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,p_120将图片放大至原尺寸的120%的示例：

在图片URL末尾添加?x-oss-process=image/resize,w_{width}时，OSS实时处理该图片，并根据指定的宽度进行等比例缩小，返回处理后的结果。其中，image/resize表示进行缩放处理，w表示期望的图片宽度。w的取值范围为[1,16384]。w的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,w_200将图片宽度固定为200像素，高度自适应进行缩小的示例：

在图片URL末尾添加?x-oss-process=image/resize,w_{width}时，OSS实时处理该图片，并根据指定的宽度进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，w表示期望的图片宽度。w的取值范围为[1,16384]。w的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,w_3000,limit_0将图片宽度固定3000像素，高度自适应进行放大的示例：

在图片URL末尾添加?x-oss-process=image/resize,h_{height}时，OSS实时处理该图片，并根据指定的高度进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，h表示期望的图片高度。h的取值范围为[1,16384]。h的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,h_100将图片高度固定为100像素，宽度自适应进行缩小的示例：

在图片URL末尾添加?x-oss-process=image/resize,h_{height}时，OSS将实时处理该图片，并根据指定的高度进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，h表示期望的图片高度。h的取值范围为[1,16384]。h的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,h_2000,limit_0将图片高度固定为2000像素，宽度自适应进行缩放的示例：

按长边缩放，图片将按指定的长边进行缩放，而短边则根据原图的比例自动调整，此时缩放模式m参数的设置不起作用。

在图片URL末尾添加image/resize,l_{length}时，OSS将实时处理该图片，并根据长边进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，l表示长边，l的取值范围为[1,16384],l的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,l_200将长边固定为200，短边自适应进行缩放的示例：

图片将按指定的短边进行缩放，而另一边则根据原图的比例自动调整，此时缩放模式m参数的设置不起作用。

在图片URL末尾添加image/resize,s_{length}时，OSS将实时处理该图片，并根据短边进行等比例缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，s表示短边，s的取值范围为[1,16384],s的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,s_200,limit_0将短边固定为200，长边自适应进行缩放的示例：

固定宽高，缩略填充在保持图像比例的同时将图像调整到指定的宽度和高度。

在图片URL末尾添加image/resize,m_pad,w_{height},h_{height},color_{RGB}时，OSS将实时处理该图片，并返回处理后的结果。其中，image/resize表示进行缩放处理，m_pad表示图片缩放为指定w与h的矩形内的最大图片，color表示指定居中填充空白部分的颜色，若不设置该参数，默认用白色填充。w表示期望的图片宽度，h表示期望的图片高度。w和h的取值范围都为[1,16384]。w和h的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,m_pad,w_100,h_100将图片宽度和高度都固定为100像素进行缩略填充缩放的示例：

以下是使用?x-oss-process=image/resize,m_pad,w_100,h_100,color_FF0000将图片宽度和高度都固定为100像素，设置填充颜色为红色进行缩略填充缩放的示例：

固定宽高，居中裁剪在原始图像的宽高比与目标尺寸的宽高比不一致时会根据目标尺寸的宽度或高度进行等比例缩放，并在缩放后将图像居中裁剪以达到固定的宽高比。

在图片URL末尾添加image/resize,m_fill,w_{height},h_{height}时，OSS将实时处理该图片，并根据指定的宽度和高度进行缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，m_fill表示图片等比缩放为延伸出指定w与h的矩形框外的最小图片，超出的部分进行居中裁剪。w表示期望的图片宽度，h表示期望的图片高度。w和h的取值范围都为[1,16384]。w和h的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,m_fill,w_100,h_100将图片宽度和高度都固定为100像素进行居中裁剪缩放的示例：

固定宽高，强制缩放用于将图像调整为指定的宽度和高度，而不考虑原始图像的宽高比。这种处理方式可能会导致图像变形，因为图像会被拉伸或缩放以适应新的尺寸。

在图片URL末尾添加image/resize,m_fixed,w_{height},h_{height}时，OSS将实时处理该图片，并根据指定的宽度和高度进行强制缩放，返回处理后的结果。其中，image/resize表示进行缩放处理，m_fixed表示图片。w表示期望的图片宽度，h表示期望的图片高度。w和h的取值范围都为[1,16384]。w和h的取值必须为正整数。

效果示例

以下是使用?x-oss-process=image/resize,m_fixed,w_100,h_100将图片宽度和高度都固定为100像素进行居中裁剪缩放的示例：

请检查是否正在使用CDN域名，并确认是否关闭忽略参数缓存功能。若通过CDN启用了过滤参数选项，则文件URL请求中的所有查询参数（位于问号“?”之后）将被移除，导致直接访问到未带参数的原始文件，如example.jpg。为确保正确缓存与访问请关闭CDN的忽略参数缓存功能，具体操作可参考忽略参数。然而，关闭此功能意味着带有不同参数的URL将被视为独立的请求，可能导致回源至OSS的频率上升，影响缓存效率。

按宽高放大图片时，需要设置limit参数为0，否则放大不生效。

例如：在以下图片中，将图片高度由原来的1875 px放大为2000 px。

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,h_2000,limit_0

OSS会根据请求的参数实时生成图片，默认不保存处理后的图片。对于经常需要展示相同处理结果（例如缩略图、裁剪图或格式转换后的图片）的应用场景，您可以使用OSS图片处理持久化功能在图片处理的请求中添加转存参数，并将处理后的图片保存至指定的Bucket。具体操作，请参见图片处理持久化。

必须对图片文件URL完成签名操作后才能正常访问。具体操作请参见上传Object后如何获取访问URL。

图片缩放会产生图片数据处理费用，按处理的原图实际大小计费。图片缩放每月提供10TB的免费额度，超出部分按照0.025元/GB进行计费。

请求缩放后的图片产生的下行流量费用按照缩放后的流量计算。例如原图为20 MB，缩放后大小为2 MB，图片产生的流量按照2 MB计算。

WebP解码异常，可能是因为图片为动图，可以开通WebP动图解码功能。