支援的作業

本節列出 Cloud CDN 圖片最佳化支援的作業。表格包含作業、語法、屬性、說明和範例等參數，有助於建立 imop 查詢。

預覽

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

Cloud CDN 圖片最佳化功能支援一系列作業，可讓您轉換圖片，例如調整大小、裁剪及縮放。每個作業都有自己的語法、支援的屬性和限制。

本頁列出 Cloud CDN 圖片最佳化支援的作業，並提供範例，協助您建立 imop 查詢。

注意： 所有參數名稱、值和作業都不區分大小寫。

作業	語法和範例	屬性	說明
Resize	?imop=Resize,width=<resized_width>,height=<resized_height> https://www.example.com/image.jpg?imop=Resize,width=250,height=125	width 類型：整數 (範圍：1 到 8192) height 類型：整數 (範圍：1 到 8192) 最大 width * height 不得超過 67 mpx (67,108,864 像素)。 縮放 (選填) 類型：列舉，值：proportional、stretch。	如果您同時指定寬度和高度參數，這項作業不會保留長寬比。如果省略任一維度，Cloud CDN 圖片最佳化功能會計算另一個維度，以維持長寬比。 圖片最佳化功能預設會強制執行嚴格的縮小策略，指定 scaling=stretch 參數可啟用放大功能，但如果只指定一個大小參數，系統就不允許這麼做。
Scale	?imop=Scale,ratio=<scale_ratio> https://www.example.com/image.jpg?imop=Scale,ratio=0.5	ratio 類型：浮點值 (最多 2 個小數位數) 限制：0 < value	這項作業會依特定比例縮放圖片，且只會強制縮小圖片。與「調整大小」和「裁剪」作業互斥。 如果單一要求中包含 Scale 作業，以及 Resize 或 Crop 作業，系統會傳回錯誤。
Crop	?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y> https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512	shape 類型：字串 (矩形、圓形) 預設值：rectangle 相依性：必須與 crop 參數搭配使用。如果值無效，系統會傳回 HTTP 400。 left、right、top、bottom 類型：浮點數 範圍：0.0 至 1.0，最多 3 個小數位數 預設值：0.0、1.0、0.0、1.0 snap_to_x, snap_to_y 類型：整數 範圍：0 以上 預設值：0 限制：必須至少包含下列其中一項： 左、右、上、下。	這項作業會根據區域標記裁剪圖片。如果為 shape 參數指定無效值，系統會傳回 HTTP 400 Bad Request。 裁剪座標會自動對齊最接近的指定 snap_to_x 或 snap_to_y 值倍數。
Canvas	?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity> https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center	width，height 類型：整數 範圍：1 到 8192 寬度 x 高度不得超過 67,108,864 像素。 gravity 類型：字串 值：center、left、right、top、bottom、top_left、top_right、bottom_left、bottom_right 預設值：center background_color 類型：字串 格式：3 位數、4 位數或 6 位數的十六進位碼 預設值：000000 (黑色)。	這項作業會新增指定尺寸和顏色的背景版面配置，藉此強化圖片。gravity 參數會決定內部圖片在這個背景畫布上的位置。
Rotate	?imop=Rotate,degrees=<rotate_degrees> https://www.example.com/image.jpg?imop=Rotate,degrees=90	degrees 類型：整數 允許的值：90、180、270。	這項作業會將目標圖片順時針旋轉。
Mirror	?imop=Mirror,flip=<flip> https://www.example.com/image.jpg?imop=Mirror,flip=h	flip 類型：字串 允許的值：h (橫向)、v (直向)、hv (橫向和直向)。	這項作業會水平、垂直或同時水平和垂直鏡像處理圖片。
Compress	?imop=Compress,strength=<value> https://www.example.com/image.jpg?imop=Compress,strength=medium	strength 類型：字串 允許的值：very_weak、weak、medium、strong、very_strong。 限制：僅支援 jpeg、avif 和 webp。超出這個範圍的值會傳回 HTTP 400。	這項作業會降低目標圖片品質，藉此壓縮圖片。strength 參數可讓您控制有效圖片壓縮層級。
Convert	?imop=Convert,format=<format> https://www.example.com/image.jpg?imop=Convert,format=webp	format 類型：字串。 允許的值：jpeg、png、webp、avif、gif 限制：如果使用未列出的值，系統會發生處理錯誤。	這項作業會變更圖片的最終傳送格式。如果瀏覽器傳入的 ACCEPT 標頭規格與處理程序發生衝突，系統會傳回 HTTP 406 Not Acceptable 錯誤。
Metadata	?imop=Metadata,preserve=<preserve> https://www.example.com/image.jpg?imop=Metadata,preserve=none	preserve 類型：字串 允許的值：無、著作權、最大 預設值：著作權	這項作業可控管執行期間的圖片中繼資料屬性處理方式： none：移除所有中繼資料屬性。 max：保留所有欄位，但 EXIF 方向和色彩設定檔除外，這些設定檔會套用至轉換 . copyright：只保留 Author、Copyright 和 Caption 欄位。
Tone	?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation> https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50	brightness 類型：整數 範圍：-100 至 100 contrast 類型：整數 範圍：-100 至 100 saturation 類型：整數 範圍：-100 至 100	這項作業會動態修改圖片的 brightness、contrast 和 saturation 級別。如果省略特定參數或設為 0，系統就不會變更該屬性。將飽和度設為 -100 會強制轉換為灰階。
Sharpen	?imop=Sharpen,strength=<sharpness> https://www.example.com/image.jpg?imop=Sharpen,strength=50	strength 類型：整數 範圍：0 至 100	這項作業會提高圖片的銳利度。
Blur	?imop=Blur,strength=<blur_size> https://www.example.com/image.jpg?imop=Blur,strength=50	strength 類型：整數 範圍：0 至 100	這項作業會對整張圖片套用局部模糊濾鏡。
Freeze	?imop=freeze,frame=<frame> https://www.example.com/image.gif?imop=freeze,frame=0	frame 類型：整數 範圍：0 至 100。	這項作業會從動畫圖片序列 (例如 GIF 動畫) 中擷取單一靜態影格。frame 參數會指定要擷取的確切影格索引。

後續步驟

• 限制
• 圖片最佳化應用實例
• 確保圖片轉換要求安全無虞
• 疑難排解和最佳做法