圖片處理
針對OSS內(nèi)存儲的圖片文件（Object），您可以在GetObject請求中攜帶圖片處理參數(shù)對圖片文件進行處理。例如添加圖片水印、轉換格式等。
操作視頻
觀看以下視頻了解如何快速處理圖片：
處理參數(shù)
OSS支持直接使用一個或多個參數(shù)處理圖片，也支持將多個參數(shù)封裝在一個樣式中批量處理圖片。有關圖片樣式的詳情，請參見圖片樣式。
當存在多個圖片處理參數(shù)時，OSS將按照參數(shù)順序對圖片進行處理。處理參數(shù)說明如下：
圖片處理 | 參數(shù) | 說明 |
resize | 將圖片縮放至指定大小。 | |
watermark | 為圖片添加圖片或文字水印。 | |
crop | 裁剪指定大小的矩形圖片。 | |
quality | 調(diào)整JPG和WebP格式圖片的質量。 | |
format | 轉換圖片格式。 | |
format | 將圖片轉換為HEIF或AVIF高壓縮比格式。 | |
info | 獲取圖片信息，包括基本信息、EXIF信息。 | |
auto-orient | 將攜帶旋轉參數(shù)的圖片進行自適應旋轉。 | |
circle | 以圖片中心點為圓心，裁剪出指定大小的圓形圖片。 | |
indexcrop | 按指定x或y軸的大小切分圖片，之后選取其中一張圖片。 | |
rounded-corners | 按指定圓角大小將圖片裁剪成圓角矩形。 | |
blur | 對圖片進行模糊處理。 | |
rotate | 按指定角度以順時針方向旋轉圖片。 | |
interlace | 將JPG格式的圖片調(diào)整為漸進顯示。 | |
average-hue | 獲取圖片主色調(diào)。 | |
bright | 調(diào)整圖片亮度。 | |
sharpen | 對圖片進行銳化處理。 | |
contrast | 調(diào)整圖片對比度。 |
例如，對原圖example.jpg添加圖片縮放resize以及質量變換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ù)后的圖片。
關于CDN回源規(guī)則的配置詳情，請參見忽略參數(shù)。
操作方式
您可以通過文件URL、API、SDK對圖片進行處理。操作方式，請參見圖片處理操作方式。
使用限制
項目 | 說明 |
圖片格式 |
|
圖片大小 | 原圖大小不能超過20 MB。 |
圖片寬高 | 除圖片旋轉對應的原圖高或者寬不能超過4,096 px外，其他圖片操作對應的原圖高或者寬不能超過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è)務有更多樣式的需求，請提交工單申請。 說明 您可以在一個樣式（Style）中包含多個圖片處理參數(shù)，快速實現(xiàn)復雜的圖片處理操作。更多信息，請參見圖片樣式。 |
處理能力 |
說明 如有計算量較大場景（如編碼WebP/AVIF/HEIF超過1080p分辨率大圖或超過上述限制），需要聯(lián)系技術支持評估實際使用限制。 |
費用說明
使用圖片處理服務時，會產(chǎn)生如下費用：
圖片處理費用
未超出免費額度時，不產(chǎn)生費用；超出免費額度后，按處理的原圖實際大小計費。計費詳情，請參見數(shù)據(jù)處理費用。
請求費用
處理圖片時會產(chǎn)生一次GetObject請求，按請求次數(shù)收費。計費詳情，請參見請求費用。
流量費用
根據(jù)處理后的圖片大小收取外網(wǎng)流出流量費用。計費詳情，請參見流量費用。
版本說明
圖片處理服務目前提供新版和舊版兩個版本的API接口，本文檔介紹新版接口的使用，舊版接口的功能今后不再更新。有關新舊版本接口使用兼容性的詳細說明，請參見新舊版本圖片處理服務及使用說明。