支持的操作

本部分列出了 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 不得超过 6700 万像素（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 依赖项：必须与裁剪参数搭配使用。如果值无效，则返回 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 类型 ：字符串 允许的值：无、版权、最大 默认值：copyright	此操作控制在执行期间如何处理图片元数据属性： 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 参数用于指定要提取的确切帧索引。

后续步骤

• 局限性
• 图片优化应用场景
• 确保图片转换请求的安全性
• 问题排查和最佳实践