圖片處理
針對OSS內(nèi)存儲的圖片文件（Object），您可以在GetObject請求中攜帶圖片處理參數(shù)對圖片文件進(jìn)行處理。例如添加圖片水印、轉(zhuǎn)換格式等。
操作視頻
觀看以下視頻了解如何快速處理圖片：
處理參數(shù)
OSS支持直接使用一個或多個參數(shù)處理圖片，也支持將多個參數(shù)封裝在一個樣式中批量處理圖片。有關(guān)圖片樣式的詳情，請參見圖片樣式。
當(dāng)存在多個圖片處理參數(shù)時，OSS將按照參數(shù)順序?qū)D片進(jìn)行處理。處理參數(shù)說明如下：
圖片處理 | 參數(shù) | 說明 |
resize | 將圖片縮放至指定大小。 | |
watermark | 為圖片添加圖片或文字水印。 | |
crop | 裁剪指定大小的矩形圖片。 | |
quality | 調(diào)整JPG和WebP格式圖片的質(zhì)量。 | |
format | 轉(zhuǎn)換圖片格式。 | |
format | 將圖片轉(zhuǎn)換為HEIF或AVIF高壓縮比格式。 | |
info | 獲取圖片信息，包括基本信息、EXIF信息。 | |
auto-orient | 將攜帶旋轉(zhuǎn)參數(shù)的圖片進(jìn)行自適應(yīng)旋轉(zhuǎn)。 | |
circle | 以圖片中心點(diǎn)為圓心，裁剪出指定大小的圓形圖片。 | |
indexcrop | 按指定x或y軸的大小切分圖片，之后選取其中一張圖片。 | |
rounded-corners | 按指定圓角大小將圖片裁剪成圓角矩形。 | |
blur | 對圖片進(jìn)行模糊處理。 | |
rotate | 按指定角度以順時針方向旋轉(zhuǎn)圖片。 | |
interlace | 將JPG格式的圖片調(diào)整為漸進(jìn)顯示。 | |
average-hue | 獲取圖片主色調(diào)。 | |
bright | 調(diào)整圖片亮度。 | |
sharpen | 對圖片進(jìn)行銳化處理。 | |
contrast | 調(diào)整圖片對比度。 |
例如，對原圖example.jpg添加圖片縮放resize以及質(zhì)量變換quality參數(shù)后，文件URL為https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300/quality,q_90。您可以通過配置不同的規(guī)則，實現(xiàn)CDN回源原圖或者經(jīng)圖片處理參數(shù)后的圖片。
回源原圖
通過CDN開啟過濾參數(shù)后，文件URL請求中問號（?）之后的參數(shù)將全部去除，即直接命中原圖
example.jpg。回源處理后的圖片
通過CDN開啟保留回源參數(shù)后，文件URL請求中問號（?）之后的所有參數(shù)將全部保留，即直接命中經(jīng)圖片處理參數(shù)后的圖片。
關(guān)于CDN回源規(guī)則的配置詳情，請參見忽略參數(shù)。
操作方式
您可以通過文件URL、API、SDK對圖片進(jìn)行處理。操作方式，請參見圖片處理操作方式。
使用限制
項目 | 說明 |
圖片格式 |
|
圖片大小 | 原圖大小不能超過20 MB。 |
圖片寬高 | 除圖片旋轉(zhuǎn)對應(yīng)的原圖高或者寬不能超過4,096 px外，其他圖片操作對應(yīng)的原圖高或者寬不能超過30,000 px，且總像素不能超過2.5億 px。 動態(tài)圖片（例如GIF圖片）的總像素計算方式為 |
圖片壓縮 | 縮放后圖片，寬或高不能超過16,384 px，且總像素不能超過16,777,216 px。 |
圖片高級壓縮 | 縮放后圖片，HEIC圖片不能超過4,096 × 4,096 px，AVIF圖片不能超過4,096 × 2,304 px。 |
圖片樣式 | 每個存儲空間下最多能創(chuàng)建50個樣式。如您的業(yè)務(wù)有更多樣式的需求，請提交工單申請。 說明 您可以在一個樣式（Style）中包含多個圖片處理參數(shù)，快速實現(xiàn)復(fù)雜的圖片處理操作。更多信息，請參見圖片樣式。 |
處理能力 |
說明 如有計算量較大場景（如編碼WebP/AVIF/HEIF超過1080p分辨率大圖或超過上述限制），需要聯(lián)系技術(shù)支持評估實際使用限制。 |
費(fèi)用說明
使用圖片處理服務(wù)時，會產(chǎn)生如下費(fèi)用：
圖片處理費(fèi)用
未超出免費(fèi)額度時，不產(chǎn)生費(fèi)用；超出免費(fèi)額度后，按處理的原圖實際大小計費(fèi)。計費(fèi)詳情，請參見數(shù)據(jù)處理費(fèi)用。
請求費(fèi)用
處理圖片時會產(chǎn)生一次GetObject請求，按請求次數(shù)收費(fèi)。計費(fèi)詳情，請參見請求費(fèi)用。
流量費(fèi)用
根據(jù)處理后的圖片大小收取外網(wǎng)流出流量費(fèi)用。計費(fèi)詳情，請參見流量費(fèi)用。
版本說明
圖片處理服務(wù)目前提供新版和舊版兩個版本的API接口，本文檔介紹新版接口的使用，舊版接口的功能今后不再更新。有關(guān)新舊版本接口使用兼容性的詳細(xì)說明，請參見新舊版本圖片處理服務(wù)及使用說明。