支持的操作

本部分列出了 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 参数用于指定要提取的确切帧索引。

    后续步骤