針對OSS記憶體儲的圖片檔案(Object),您可以在GetObject請求中攜帶圖片處理參數對圖片檔案進行處理。例如添加圖片浮水印、轉換格式等。
處理參數
OSS支援直接使用一個或多個參數處理圖片,也支援將多個參數封裝在一個樣式中批量處理圖片。有關圖片樣式的詳情,請參見圖片樣式。
當存在多個圖片處理參數時,OSS將按照參數順序對圖片進行處理。處理參數說明如下:
圖片處理 | 參數 | 說明 |
resize | 將圖片縮放至指定大小。 | |
watermark | 為圖片添加圖片或文字浮水印。 | |
crop | 裁剪指定大小的矩形圖片。 | |
quality | 調整JPG和WebP格式圖片的品質。 | |
format | 轉換圖片格式。 | |
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圖片)的總像素計算方式為 |
圖片壓縮 | 縮放後圖片,寬或高不能超過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介面,本文檔介紹新版介面的使用,舊版介面的功能今後不再更新。有關新舊版本介面使用相容性的詳細說明,請參見新舊版本圖片處理服務及使用說明。