Transformation reference

Complete guide to all image and video transformation parameters. Chain them together via URL for powerful pipelines.

Dimensions & cropping

Parameter Example Description
w_ w_800 Set width in pixels. Maintains aspect ratio if height is omitted.
h_ h_600 Set height in pixels. Maintains aspect ratio if width is omitted.
c_ c_fill Crop mode: fill, fit, scale, crop, thumb, pad.
g_ g_face Gravity: center, face, auto, north, south, east, west.
ar_ ar_16:9 Aspect ratio constraint for cropping operations.

Output optimization

Parameter Example Description
f_ f_webp Output format: auto, webp, avif, jxl, jpeg, png, gif.
q_ q_auto Quality: 1-100, auto, auto:low, auto:best, auto:eco.
dpr_ dpr_2 Device pixel ratio multiplier for retina displays.
fl_ fl_progressive Flags: progressive, strip, lossy, lossless, animated.

Visual effects

Parameter Example Description
e_sharpen e_sharpen:80 Sharpen image with configurable intensity (0-100).
e_blur e_blur:500 Gaussian blur with configurable radius.
e_grayscale e_grayscale Convert to grayscale.
e_bgremoval e_bgremoval AI-powered background removal.
e_upscale e_upscale:2x AI upscaling to 2x or 4x resolution.

Watermarks & overlays

Parameter Example Description
l_ l_logo.png Image overlay source file.
l_text: l_text:Hello Text overlay with font and style options.
o_ o_60 Overlay opacity (0-100).
g_ g_southeast Overlay position gravity.

Ready to start transforming?

Try any transformation with our free tier — 25GB included monthly.

Get Started Free Full API Docs