1. Dimensions & Sizing
Resize your images by specifying thewidth and/or height.
Crop & Fit (fit)
When specifying both width and height, you can control how the image fits within those dimensions using the fit parameter.
Example:
Explicit Crop (crop)
If you need exact pixel-perfect control over the crop, you can specify coordinates directly instead of using fit.
Example:
Extract a 200x200 square starting 50px from the left and 100px from the top:
2. Formatting & Quality
Convert image types and compress them for optimal web delivery. Supported source image formats include JPEG, PNG, WebP, GIF, TIFF, BMP, HEIC/HEIF, and SVG.Conversion Boundaries: Image conversions must remain within the image family (
jpeg, png, webp, avif, tiff, gif). Requesting video output formats (such as mp4 or webm) on image assets is strictly blocked and returns an error.3. Position & Focal Point
When usingfit=cover or cropping, you can specify which part of the image should be kept in view using the gravity parameter.
Example:
Crop a square thumbnail but prioritize the most “interesting” part of the image (often faces/high contrast areas):
4. Effects & Adjustments
Apply visual effects to the image.
Example:
Create a heavily blurred low-quality placeholder: