全部產品
Search
文件中心

Object Storage Service:圖片處理

更新時間:Nov 30, 2024

針對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對圖片進行處理。操作方式,請參見圖片處理操作方式

使用限制

專案

說明

圖片格式

  • 原圖只支援JPG、PNG、BMP、GIF、WebP、TIFF、HEIC、AVIF。

  • 動態圖片(例如GIF格式圖片)僅支援縮放、裁剪、旋轉以及添加圖片浮水印的操作,不支援其它圖片處理操作。

  • 如果需要對WebP格式的動態圖片進行編解碼,請提交工單申請。

圖片大小

原圖大小不能超過20 MB。

圖片寬高

除圖片旋轉對應的原圖高或者寬不能超過4,096 px外,其他圖片操作對應的原圖高或者寬不能超過30,000 px,且總像素不能超過2.5億 px。

動態圖片(例如GIF圖片)的總像素計算方式為寬*高*圖片幀數;非動態圖片(例如PNG圖片)的總像素計算方式為寬*高

圖片壓縮

縮放後圖片,寬或高不能超過16,384 px,且總像素不能超過16,777,216 px。

圖片進階壓縮

縮放後圖片,HEIC圖片不能超過4,096 × 4,096 px,AVIF圖片不能超過4,096 × 2,304 px。

圖片樣式

每個儲存空間下最多能建立50個樣式。如您的業務有更多樣式的需求,請提交工單申請。

說明

您可以在一個樣式(Style)中包含多個圖片處理參數,快速實現複雜的圖片處理操作。更多資訊,請參見圖片樣式

處理能力

  • 每秒圖片處理量(按原圖大小計)

    • 華東1(杭州)、華東2(上海)、華北2(北京)、華北 3(張家口)、華南1(深圳):20 MB/s。

    • 其他地區:2 MB/s。

  • 每秒請求數QPS(Query Per Second)

    • 華東1(杭州)、華東2(上海)、華北2(北京)、華北 3(張家口)、華南1(深圳):50。

    • 其他地區:5。

說明

如有計算量較大情境(如編碼WebP/AVIF/HEIF超過1080p解析度大圖或超過上述限制),需要聯絡支援人員評估實際使用限制。

費用說明

使用圖片處理服務時,會產生如下費用:

  • 請求費用

    處理圖片時會產生一次GetObject請求,按請求次數收費。計費詳情,請參見請求費用

  • 流量費用

    根據處理後的圖片大小收取外網流出流量費用。計費詳情,請參見流量費用

版本說明

圖片處理服務目前提供新版和舊版兩個版本的API介面,本文檔介紹新版介面的使用,舊版介面的功能今後不再更新。有關新舊版本介面使用相容性的詳細說明,請參見新舊版本圖片處理服務及使用說明