对于存储在OSS中的图片,您可以在GetObject
请求中添加图片缩放参数,以缩小或放大图片。
使用限制
限制 | 项目 | 说明 |
原图限制 | 图片格式 | 原图只支持JPG、PNG、BMP、GIF、WebP、TIFF、HEIC。 说明
|
图片大小 | 原图大小不能超过20 MB。如果您需要调整原图大小限制,请在配额中心申请。 | |
图片宽高 | 原图高或者宽不能超过30,000 px,且总像素不能超过2.5亿 px。 说明 动态图片(例如GIF图片)的总像素计算方式为 | |
缩放后限制 | 图片缩放 | 缩放后图片宽或高不能超过16,384 px,且总像素不能超过16,777,216 px。 |
计费说明
使用图片处理服务时,会产生图片处理费用、GET请求费用和流量费用。详细计费介绍请参见计费说明。
操作说明
在OSS中,当您在图片URL末尾添加?x-oss-process=image/resize,parame_value
参数时,OSS会实时处理该图片,并按指定的百分比进行等比例缩放,返回处理后的结果。image/resize
表示进行缩放处理,parame
为图片缩放支持的参数,value
为参数取值,对于参数的详细说明在下文图片缩放参数中给出。
OSS 会根据请求参数实时生成处理后的图片,默认情况下不保存这些图片。对于需要保存处理结果的应用场景,可以使用 OSS 的图片处理持久化功能。在图片处理请求中添加转存参数,将处理后的图片保存到指定的 Bucket。具体操作,请参见图片处理持久化。
公共读图片
对于公共读或公共读写的图片,可以直接在图片URL后添加处理参数,以允许任何人永久匿名访问处理后的图片。
以下是公共读图片URL添加?x-oss-process=image/resize,parame_value
参数的操作说明,您只需要根据您的业务需求将parame_value
替换为具体的参数和值,同时,支持多个参数之间的组合使用。
原始图片URL | 添加处理参数后的图片URL |
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241114/vpxdmi/picprocess.jpeg | https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241114/vpxdmi/picprocess.jpeg?x-oss-process=image/resize,parame_value |
私有图片
对于私有图片,除了在URL后添加处理参数外,还需包括签名信息。您可以使用OSS SDK生成带有图片缩放参数的签名URL,以便允许获取该签名URL的用户临时访问处理后的图片。
使用阿里云SDK
以下仅列举常见SDK缩放图片的代码示例。如需使用其他SDK缩放图片的代码示例,请参见SDK简介。
使用OSS SDK为私有图片生成带?x-oss-process=image/parame_value
参数的签名URL的示例:
# -*- 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)
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();
}
}
}
}
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)
}
}
<?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);
const OSS = require("ali-oss");
const client = new OSS({
// yourregion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
region: "oss-cn-hangzhou",
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// yourbucketname填写存储空间名称。
bucket: "examplebucket",
});
// 图片缩放 parame_value需要替换为具体的参数和值,如“p_50”表示图片等比例缩小为之前的50%
const signUrl = client.signatureUrl("example.png", {
expires: 3600,
process: "image/resize,parame_value",
});
console.log("signUrl=" + signUrl);
生成的签名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,w_100 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
图片缩放参数
parame
参数和value
取值说明:
等比例缩放
名称参数 | 描述 | 取值范围 |
p | 按百分比缩放图片。 | [1,1000] 小于100为缩小,大于100为放大。 |
指定宽高缩放
参数 | 描述 | 取值 |
w | 指定目标缩放图的宽度。 | [1,16384] |
h | 指定目标缩放图的高度。 | [1,16384] |
m | 指定缩放的模式。 |
关于按不同模式进行缩放后得到的图片说明,请参见缩放计算方式。 说明 当缩放模式设置为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 | 指定目标缩放图的最短边。 说明 当仅选择 当同时设置了 | [1,16384] |
limit | 当目标图片分辨率大于原图分辨率时,设置是否进行缩放。 重要 目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加 |
说明 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(默认值) 等比缩放,缩略图限制在指定w与h的矩形内的最大图片。 | 150 px*75 px |
mfit 等比缩放,缩略图为延伸出指定w与h的矩形框外的最小图片。 | 160 px*80 px | ||
fill 等比缩放,缩略图为延伸出指定w与h的矩形框外的最小图片,之后按照固定宽高进行裁剪。 | 150 px*80 px | ||
pad 等比缩放,缩略图限制在指定w与h的矩形内的最大图片再按照固定宽高进行颜色填充。 | 150 px*80 px | ||
fixed 按照固定宽高强制缩放,若宽高与原图宽高比例不同,则会导致图片变形。 | 150 px*80 px |
当缩放模式指定为lfit或mfit时,如果等比为小数,则四舍五入保留整数。