图片缩放

对于存储在OSS中的图片,您可以在GetObject请求中添加图片缩放参数,以缩小或放大图片。

使用场景

  • 网页设计: 在网页设计和移动应用开发中,图片需要根据不同的屏幕尺寸和分辨率自适应显示。

  • 社交媒体: 用户上传的图片尺寸各异,平台需要统一处理为适合预览的尺寸。

  • 图像识别和分析:在计算机视觉和机器学习领域,为了提高处理效率,对图像进行缩放。

  • 存储和传输:缩小图片尺寸可以减少存储空间和数据传输时间。

使用限制

限制

项目

说明

原图限制

图片格式

原图只支持JPG、PNG、BMP、GIF、WebP、TIFF、HEIC。

说明
  • GIF格式的图片只支持指定宽高缩小,不支持按百分比缩小(按百分比缩小的情况下,动态图会变成静态图)。

  • GIF格式的图片不支持放大。

图片大小

原图大小不能超过20 MB。如果您需要调整原图大小限制,请在配额中心申请

图片宽高

原图高或者宽不能超过30,000 px,且总像素不能超过2.5亿 px。

说明

动态图片(例如GIF图片)的总像素计算方式为宽*高*图片帧数;非动态图片(例如PNG图片)的总像素计算方式为宽*高

缩放后限制

图片缩放

缩放后图片宽或高不能超过16,384 px,且总像素不能超过16,777,216 px。

计费说明

使用图片处理服务时,会产生图片处理费用、GET请求费用和流量费用。详细计费介绍请参见计费说明

操作方式

您可以通过文件URL、SDK、API方式设置图片处理参数。使用文件URL仅适用于公共访问的图片。如果是私有访问的图片,请使用SDK、API处理图片。更多信息,请参见图片处理操作方式

OSS中,当您在图片URL末尾添加?x-oss-process=image/resize,parame_value参数时,OSS会实时处理该图片,并按指定的百分比进行等比例缩放,返回处理后的结果。image/resize表示进行缩放处理,parame为图片缩放支持的参数,value为参数取值,对于参数的详细说明在下文参数说明中给出。

公共读图片

对于公共读的图片,可以直接在图片URL后添加处理参数,以允许任何人永久匿名访问处理后的图片。

以下是公共读图片URL添加?x-oss-process=image/resize,parame_value参数的操作说明,您只需要根据您的业务需求将parame_value替换为具体的参数和值,同时,支持多个参数之间的组合使用。

原始图片URL

添加处理参数后的图片URL

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

私有图片

对于私有图片,除了在URL后添加处理参数外,还需包括签名信息。您可以使用OSS SDK生成带有图片缩放参数的签名URL,以便允许获取该签名URL的用户临时访问处理后的图片。

使用阿里云SDK

以下仅列举常见SDK缩放图片的代码示例。如需使用其他SDK缩放图片的代码示例,请参见SDK简介

使用OSS SDK为私有图片生成带?x-oss-process=image/parame_value参数的签名URL的示例:

Java

package com.aliyun.oss.demo;
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GeneratePresignedUrlRequest;
import java.net.URL;
import java.util.Date;

public class Demo {
    public static void main(String[] args) throws Throwable {
        // Endpoint以华东1(杭州)为例,其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称,例如examplebucket。
        String bucketName = "examplebucket";
        // 填写Object完整路径。如果图片不在Bucket根目录,需携带图片完整路径,例如exampledir/exampleobject.jpg
        String objectName = "exampledir/exampleobject.png";
        // 填写Bucket所在地域。以华东1(杭州)为例,Region填写为cn-hangzhou。
        String region = "cn-hangzhou";

        // 创建OSSClient实例。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 图片缩放,parame_value需要替换为具体的参数和值,如“p_50”表示图片等比例缩小为之前的50%
            String style = "image/resize,parame_value";
            // 指定签名URL过期时间为3600秒)
            Date expiration = new Date(new Date().getTime() + 3600 );
            GeneratePresignedUrlRequest req = new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
            req.setExpiration(expiration);
            req.setProcess(style);
            URL signedUrl = ossClient.generatePresignedUrl(req);
            System.out.println(signedUrl);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

PHP

<?php
if (is_file(__DIR__ . '/../autoload.php')) 
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;

// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "yourEndpoint";
// 填写Bucket名称,例如examplebucket。
$bucket= "examplebucket";
// 填写Object完整路径,例如exampledir/exampleobject.jpg。Object完整路径中不能包含Bucket名称。
$object = "exampledir/exampleobject.jpg";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);

// 生成一个带图片处理参数的签名的URL,有效期是3600秒,可以直接使用浏览器访问。
$timeout = 3600;

$options = array(
    // 图片缩放,parame_value需要替换为具体的参数和值,如“p_50”表示图片等比例缩小为之前的50%
    OssClient::OSS_PROCESS => "image/resize,parame_value");

$signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET", $options);
print("rtmp url: \n" . $signedUrl);

Python

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填写Bucket名称
bucket = 'examplebucket'

# 填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'

# 填写阿里云通用Region ID
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, bucket, region=region)

# 指定原图名称。如果图片不在Bucket根目录,需携带图片完整路径,例如exampledir/exampleobject.jpg
key = 'exampledir/exampleobject.png'

# 指定过期时间,单位秒
expire_time = 3600

# 图片缩放,parame_value需要替换为具体的参数和值,如“p_50”表示图片等比例缩小为之前的50%
image_process = 'image/resize,parame_value'

# 生成签名URL,带上图片处理参数
url = bucket.sign_url('GET', key, expire_time, params={'x-oss-process': image_process}, slash_safe=True)

# 打印签名URL
print(url)

Go

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 创建OSSClient实例。
	// yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
	// yourRegion填写Bucket所在地域,以华东1(杭州)为例,填写为cn-hangzhou。其它Region请按实际情况填写。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 设置签名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		HandleError(err)
	}

	// 指定图片所在Bucket的名称,例如examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}
	// 指定图片名称。如果图片不在Bucket根目录,需携带文件完整路径,例如exampledir/exampleobject.jpg。
	ossImageName := "exampledir/exampleobject.png"
	// 生成带签名的URL,并指定过期时间为3600s。(最长有效时间为32400秒)
	// 图片缩放,parame_value需要替换为具体的参数和值,如“p_50”表示图片等比例缩小为之前的50%
	signedURL, err := bucket.SignURL(ossImageName, oss.HTTPGet, 3600, oss.Process("image/resize,parame_value"))
	if err != nil {
		HandleError(err)
	} else {
		fmt.Println(signedURL)
	}
}

生成的签名URL示例如下:

https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampledir/exampleobject.png?x-oss-process=image%2Fresize%2Cp_50&x-oss-date=20241111T113707Z&x-oss-expires=3600&x-oss-signature-version=OSS4-HMAC-SHA256&x-oss-credential=LTAI********************%2F20241111%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-signature=6fd07a2ba50bf6891474dc56aed976b556b6fbcd901cfd01bcde5399bf4802cb

使用REST API

如果您的程序自定义要求较高,您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。关于公共请求头Authorization的计算方法,请参见签名版本4(推荐)

您可以通过在GetObject接口中添加图片缩放参数的方式来处理图片。更多信息,请参见GetObject

GET /oss.jpg?x-oss-process=image/resize,p_50 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

参数说明

操作名称:resize

parame参数和value取值说明:

等比例缩放

名称参数

描述

取值范围

p

按百分比缩放图片。

[1,1000]

小于100为缩小,大于100为放大。

指定宽高缩放

参数

描述

取值

w

指定目标缩放图的宽度。

[1,16384]

h

指定目标缩放图的高度。

[1,16384]

m

指定缩放的模式。

  • lfit(默认值):等比缩放至指定宽高区域内最大图形。

  • mfit:等比缩放至覆盖指定宽高区域。

  • fill:等比缩放至覆盖指定宽高区域并居中裁剪。

  • pad:等比缩放至指定宽高内最大图形并填充颜色至指定尺寸。

  • fixed:固定宽高,强制缩放。

关于按不同模式进行缩放后得到的图片说明,请参见缩放计算方式

说明

当缩放模式设置为m模式下的任意值,并且指定了目标缩放图的宽度(w)或高度(h),则目标缩放图的最长边(l)或最短边(s)的设定将不会生效。

l

指定目标缩放图的最长边。

说明

长边是指原尺寸与目标尺寸的比值大的那条边。例如原图为100 px*200 px,缩放为100px*100 px,由于200/100=2,100/100=1,2>1,所以在这个缩放中200那条是长边,100那条是短边。

[1,16384]

s

指定目标缩放图的最短边。

说明

当仅选择l(长边)或s(短边)进行指定时,图片将按指定的边进行缩放,而另一边则根据原图的比例自动调整,此时m参数的设置不起作用。

当同时设置了ls参数时,图片的缩放会基于保持长宽比的原则进行,此时m参数将发挥作用。若未明确指定缩放模式,系统将采用默认的lfit方式处理。

[1,16384]

limit

当目标图片分辨率大于原图分辨率时,设置是否进行缩放。

重要

目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

  • 1(默认值):返回按照原图分辨率转换的图片(可能和原图的体积不一样)。

  • 0:按指定参数进行缩放。

说明

GIF格式的图片只支持缩小,不支持放大。

color

当缩放模式选择为pad(缩放填充)时,可以设置填充的颜色。

RGB颜色值,例如:000000表示黑色,FFFFFF表示白色。

默认值:FFFFFF(白色)

说明

若缩放时只指定宽度或者高度:

  • 缩放模式为lfit,mfit,fixed时,会按比例缩放图片。例如原图为256px*144 px,将高缩放为100 px,则宽缩放为178px。

  • 缩放模式为pad,fill时,会将原图宽高按照指定值进行缩放。例如原图为256px*144px,将高缩放为100 px,则宽也缩放为100 px。

缩放计算方式

原图大小

指定缩放参数

缩放模式

缩放后大小

200 px*100 px

150 px*80 px

lfit(默认值)

等比缩放,缩略图限制在指定wh的矩形内的最大图片。

150 px*75 px

lfit

mfit

等比缩放,缩略图为延伸出指定wh的矩形框外的最小图片。

160 px*80 px

mfit

fill

等比缩放,缩略图为延伸出指定wh的矩形框外的最小图片,之后按照固定宽高进行裁剪。

150 px*80 px

fill

pad

等比缩放,缩略图限制在指定wh的矩形内的最大图片再按照固定宽高进行颜色填充。

150 px*80 px

pad

fixed

按照固定宽高强制缩放,若宽高与原图宽高比例不同,则会导致图片变形。

150 px*80 px

fixed

说明

当缩放模式指定为lfitmfit时,如果等比为小数,则四舍五入保留整数。

使用示例

等比例缩小

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,p_50

图片尺寸

2500 x 1875 px

1250 x 938 px

等比例放大

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,p_120

图片尺寸

2500 x 1875 px

3000 x 2250 px

宽度固定,高度自适应缩小

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,w_200

图片尺寸

2500 x 1875 px

200 x 150 px

宽度固定,高度自适应放大

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

重要

由于当目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,w_3000,limit_0

图片尺寸

2500 x 1875 px

3000 x 2250 px

高度固定,宽度自适应缩小

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,h_100

图片尺寸

2500 x 1875 px

133 x 100 px

高度固定,宽度自适应放大

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

重要

由于当目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

图片尺寸

2500 x 1875 px

2667 x 2000 px

长边固定,短边自适应缩放

说明

长边是指在原图尺寸与目标图尺寸之间,其比例较大的那一边。例如,如果原始图像的尺寸为100px * 200px,而目标尺寸为100px * 100px,则计算两边的比例分别为100/100 = 1 和 200/100 = 2。因为2大于1,所以在这种缩放情况下,原图中的200px边被认为是长边,而100px边则是短边。

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

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

重要

由于当目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,l_200

图片尺寸

2500 x 1875 px

200 x 150 px

短边固定,长边自适应缩放

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

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

重要

由于当目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

图片处理URL:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg?x-oss-process=image/resize,s_200

图片尺寸

2500 x 1875 px

267 x 200 px

固定宽高,缩略填充

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

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

图片尺寸

2500 x 1875 px

100 x 100 px

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

图片尺寸

2500 x 1875 px

100 x 100 px

固定宽高,居中裁剪

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

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

图片尺寸

2500 x 1875 px

100 x 100 px

强制宽高缩放

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

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

效果示例

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

对比项目

原图

处理后的图片

图片预览

image

image

URL

原图URL: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example1.jpg

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

图片尺寸

2500 x 1875 px

100 x 100 px

常见问题

如何持久化存储处理后的图片?

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

缩放后的图片读写权限为私有,如何正常访问?

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

图片缩放是否产生图片数据处理费用?

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

请求缩放后的图片产生的下行流量是按原图还是缩放后的图片计算?

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

按宽高放大图片不生效怎么办?

按宽高放大图片时,需要设置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

图片缩放的参数不生效怎么办?

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

原图WebP解码异常怎么办?

WebP解码异常,可能是因为图片为动图,可以提交工单开通WebP动图解码功能。