針對OSS記憶體儲的圖片檔案（Object），您可以在GetObject請求中攜帶圖片處理參數對圖片檔案進行處理。例如添加圖片浮水印、轉換格式等。
處理參數
OSS支援直接使用一個或多個參數處理圖片，也支援將多個參數封裝在一個樣式中批量處理圖片。有關圖片樣式的詳情，請參見圖片樣式。
當存在多個圖片處理參數時，OSS將按照參數順序對圖片進行處理。處理參數說明如下：
|
圖片處理 |
參數 |
說明 |
|
resize |
將圖片縮放至指定大小。 |
|
|
watermark |
為圖片添加圖片或文字浮水印。 |
|
|
crop |
裁剪指定大小的矩形圖片。 |
|
|
quality |
調整JPG和WebP格式圖片的品質。 |
|
|
format |
轉換圖片格式。 |
|
|
format |
將圖片轉換為HEIF或AVIF高壓縮比格式。 |
|
|
info |
擷取圖片資訊，包括基本資料、EXIF資訊。 |
|
|
auto-orient |
將攜帶旋轉參數的圖片進行自適應旋轉。 |
|
|
circle |
以圖片中心點為圓心，裁剪出指定大小的圓形圖片。 |
|
|
indexcrop |
按指定x或y軸的大小切分圖片，之後選取其中一張圖片。 |
|
|
rounded-corners |
按指定圓角大小將圖片裁剪成圓角矩形。 |
|
|
blur |
對圖片進行模糊處理。 |
|
|
rotate |
按指定角度以順時針方向旋轉圖片。 |
|
|
interlace |
將JPG格式的圖片調整為漸進顯示。 |
|
|
average-hue |
擷取圖片主色調。 |
|
|
bright |
調整圖片亮度。 |
|
|
sharpen |
對圖片進行銳利化處理。 |
|
|
contrast |
調整圖片對比。 |
例如，對原圖example.jpg添加圖片縮放resize以及品質變換quality參數後，檔案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。您可以通過配置不同的規則，實現CDN回源原圖或者經圖片處理參數後的圖片。
-
回源原圖
通過CDN開啟過濾參數後，檔案URL請求中問號（?）之後的參數將全部去除，即直接命中原圖
example.jpg。 -
回源處理後的圖片
通過CDN開啟保留回源參數後，檔案URL請求中問號（?）之後的所有參數將全部保留，即直接命中經圖片處理參數後的圖片。
關於CDN回源規則的配置詳情，請參見忽略參數。
操作方式
您可以通過檔案URL、API、SDK對圖片進行處理。操作方式，請參見圖片處理操作方式。
使用限制
|
專案 |
說明 |
|
圖片格式 |
|
|
圖片大小 |
原圖大小不能超過20 MB。 |
|
圖片寬高 |
除圖片旋轉對應的原圖高或者寬不能超過4,096 px外，其他圖片操作對應的原圖高或者寬不能超過30,000 px，且總像素不能超過2.5億 px。 動態圖片（例如GIF圖片）的總像素計算方式為 說明
轉換為WebP格式時，原圖的寬和高均不能超過16,383 px，否則會導致轉換失敗。 |
|
圖片壓縮 |
縮放後圖片，寬或高不能超過16,384 px，且總像素不能超過16,777,216 px。 |
|
圖片進階壓縮 |
縮放後圖片，HEIC圖片不能超過4,096 × 4,096 px，AVIF圖片不能超過4,096 × 2,304 px。 |
|
圖片樣式 |
每個儲存空間下最多能建立50個樣式。如您的業務有更多樣式的需求，請提交工單申請。 說明
您可以在一個樣式（Style）中包含多個圖片處理參數，快速實現複雜的圖片處理操作。更多資訊，請參見圖片樣式。 |
|
處理能力 |
說明
如有計算量較大情境（如編碼WebP/AVIF/HEIF超過1080p解析度大圖或超過上述限制），需要聯絡支援人員評估實際使用限制。 |
費用說明
版本說明
圖片處理服務目前提供新版和舊版兩個版本的API介面，本文檔介紹新版介面的使用，舊版介面的功能今後不再更新。有關新舊版本介面使用相容性的詳細說明，請參見新舊版本圖片處理服務及使用說明。