使用URL處理
更新時間 2025-10-21 11:16:44
最近更新時間: 2025-10-21 11:16:44
分享文章
介紹通過URL處理進行媒體存儲圖片處理操作 。
使用說明
媒體存儲支持通過特定規則的URI來進行提供圖片處理操作，用戶可根據需求選擇對應的參數進行使用。
圖片處理參數可參考圖片處理-概述，根據概述指引獲取相關參數。
前提條件
使用URL參數進行圖片處理前，用戶需登錄控制臺并上傳圖片文件。
圖片處理僅在部分資源池適用，具體可參考：資源池與區域節點。
URL規則
媒體存儲的圖片處理URL由4個部分組成，包括：對象存儲域名、原圖所在桶名稱、原圖片名稱和處理命令及樣式參數組成。
URL規則為：//endpoint/bucket/objectName?x-amz-process=image/processCommands。
其中：
- endpoint：桶所在資源池對應的對象存儲終端節點，可以在桶基礎信息中獲取。
- bucket：原圖片所在的桶名稱。
- objectName：原圖片的名稱。
- processCommands：處理命令及樣式參數。處理命令和樣式參數間以多種符號區分。若不輸入任何處理命令，則返回原圖片。
處理參數
| 圖片處理 | 參數 | 說明 |
|---|---|---|
| 圖片縮放 | resize | 將圖片縮放至指定大小。 |
| 格式轉換 | format | 轉換圖片格式。 |
| 旋轉 | rotate | 按指定角度以順時針方向旋轉圖片。 |
| EXIF信息 | info/strip | 獲取或刪除圖片的exif信息。 |
| 質量變換 | quality | 調整JPG和WebP格式圖片的質量。 |
| 亮度 | bright | 調整圖片亮度。 |
| 漸進顯示 | interlace | 將JPG格式的圖片調整為漸進顯示。 |
| 模糊 | blur | 對圖片進行模糊處理。 |
| 自定義裁剪 | crop | 裁剪指定大小的矩形圖片。 |
| 圖片水印 | watermark | 為圖片添加圖片或文字水印。 |
| 自適應方向 | auto-orient | 將攜帶旋轉參數的圖片進行自適應旋轉。 |
| 獲取平均色調 | average-hue | 獲取圖片平均色調信息。 |
| 銳化 | sharpen | 通過銳化參數，提高原圖的清晰度。 |
| 對比度 | contrast | 調整原圖的對比度。 |
| 內切圓 | circle | 將圖片處理成內切圓。 |
| 圓角矩形 | rounded-corners | 將圖片的4個角切成圓角。 |
| 索引切割 | indexcrop | 按指定大小分割原圖并截取需要的圖片。 |
符號說明
| 名稱 | 符號 | 順序 | 說明 |
|---|---|---|---|
| 參數連接符 | _ | 固定順序 | 樣式參數與參數值之間的連接符 |
| 樣式分隔符 | , | 無序 | 多個樣式參數之間的分隔符 |
| 命令分隔符 | / | 有序 | 多個處理命令之間的分隔符 |
具體樣式參數請參考各個具體圖片處理操作的說明文檔。
