Media API - Transformations
The complete reference for performing real-time image transformations. Learn how to resize, crop, adjust colors, apply effects, and more with simple REST endpoints.
What is the Media API?
The Media API is a CDN-based service designed to perform single-shot and chained image transformations on demand. It's built for modern web and mobile workflows where images need to be optimized, adjusted, or converted automatically.
Simply construct a URL with your transformation parameters and asset ID. On the first request to a unique URL, the transformation is applied dynamically and cached for future requests—no pre-generating static variants needed. Everything happens in real-time through our CDN infrastructure.
How it works: First request to a URL returns X-Cache: MISS while the transformation is applied. Subsequent requests return X-Cache: HIT and are served instantly from the CDN.
Why use the Media API?
On-demand transformations — Resize, crop, adjust colors, and apply effects in real-time without pre-generating static assets
Chain transformations — Combine multiple operations in a single request for complex, multi-step image workflows
Flexible response formats — Get binary image data or JSON responses depending on your application needs
Simple REST endpoints — Intuitive API that maps directly to transformation categories and functions
Common use cases
Responsive Images
Generate optimized variants for different screen sizes and resolutions on demand.
User Uploads
Convert user-submitted images to consistent formats, sizes, and quality standards automatically.
Brand Styling
Apply brand colors, filters, and effects to e-commerce or marketing assets in real-time.
Ready to explore available transformations?
Browse Transformations