Supported operations

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125

• width type: Integer (Range: 1–8192)
• height type: Integer (Range: 1–8192)

the maximum width * height can't exceed 67 mpx (67,108,864 pixels).

This operation doesn't preserve the aspect ratio when you specify both the width and height parameters. If you omit either dimension, Cloud CDN image optimization calculates the other to maintain the aspect ratio.

By default, image optimization enforces a strict downscale-only strategy. Specifying the scaling=stretch parameter enables upscaling, but the system doesn't permit this if you specify only one size parameter.

Scale

?imop=Scale,ratio=<scale_ratio>

https://www.example.com/image.jpg?imop=Scale,ratio=0.5

• Type: Float (limited to 2 decimal digits)
• Constraint: 0 < value

This operation scales the image by a specific factor and enforces downscaling only. Mutually exclusive with Resize and Crop operations.

If you include the Scale operation with the Resize or Crop operations within a single request, the system returns an error.

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

• Type: String (rectangle, circle)
• Default: rectangle
• Dependency: must be used with the crop parameter. Invalid value will return HTTP 400.

• Type: Float
• Range: 0.0 to 1.0, max 3 decimal places
• Default: 0.0, 1.0, 0.0, 1.0

• Type: Integer
• Range: 0 or greater
• Default: 0
• Constraint: mandatory to include at least one of: left, right, top, bottom.

This operation crops the image based on regional markers. If you specify an invalid value for the shape parameter, the system returns an HTTP 400 Bad Request.

The crop coordinates automatically snap to the nearest multiple of the specified snap_to_x or snap_to_y value.

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

• Type: Integer
• Range: 1–8192
• Max width x height cannot exceed 67,108,864 pixels.

• Type: String
• Values: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
• Default: center

• Type: String
• Format: 3-digit, 4-digit, or 6-digit hex codes
• Default: 000000 (black).

This operation enhances images by adding a background layout of specified dimensions and color. The gravity parameter dictates the placement of the inner image on this background canvas.

Rotate

?imop=Rotate,degrees=<rotate_degrees>

https://www.example.com/image.jpg?imop=Rotate,degrees=90

• Type: Integer
• Allowed values: 90, 180, 270.

This operation rotates the target image clockwise.

Mirror

?imop=Mirror,flip=<flip>

https://www.example.com/image.jpg?imop=Mirror,flip=h

• Type: String
• Allowed values: h (horizontal), v (vertical), hv (horizontal & vertical).

This operation mirrors the image either horizontally, vertically, or both.

Compress

?imop=Compress,strength=<value>

https://www.example.com/image.jpg?imop=Compress,strength=medium

• Type: String
• Allowed values: very_weak, weak, medium, strong, very_strong.
• Constraint: supported only for jpeg, avif, and webp. Values outside this range return HTTP 400.

This operation compresses the image by decreasing the target image quality. The strength parameter lets you control the active image compression level.

Convert

?imop=Convert,format=<format>

https://www.example.com/image.jpg?imop=Convert,format=webp

• Type: String.
• Allowed values: jpeg, png, webp, avif, gif
• Constraint: Any other unlisted value will result in a processing error.

This operation changes the final delivery format of the image. If there is a processing conflict with the browser's incoming ACCEPT header specification, the system returns an HTTP 406 Not Acceptable error.

Metadata

?imop=Metadata,preserve=<preserve>

https://www.example.com/image.jpg?imop=Metadata,preserve=none

• Type: String
• Allowed values: none, copyright, max
• Default: copyright

This operation controls how image metadata properties are handled during execution:

none: Removes all metadata properties.

max: preserves all fields except EXIF orientation and color profiles which are applied on the transformation

copyright: keeps only Author, Copyright, and Caption fields.

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
  • Type: Integer
  • Range: -100 to 100
• contrast
  • Type: Integer
  • Range: -100 to 100
• saturation
  • Type: Integer
  • Range: -100 to 100

This operation dynamically modifies the brightness, contrast, and saturation levels of an image. If you omit a specific parameter or set to 0, the system doesn't change that attribute. Setting saturation to -100 forces grayscale conversion.

Sharpen

?imop=Sharpen,strength=<sharpness>

https://www.example.com/image.jpg?imop=Sharpen,strength=50

• Type: Integer
• Range: 0 to 100

This operation increases the sharpness of the image.

Blur

?imop=Blur,strength=<blur_size>

https://www.example.com/image.jpg?imop=Blur,strength=50

• Type: Integer
• Range: 0 to 100

This operation applies a localized blur filter across the image.

Freeze

?imop=freeze,frame=<frame>

https://www.example.com/image.gif?imop=freeze,frame=0

• Type: Integer
• Range: 0 to 100.

This operation extracts a single, static frame from an animated image sequence, such as an animated GIF. The frame parameter specifies the exact frame index to extract.