--- canonical: https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/ title: Media Delivery API Guide description: Reference guide to every parameter in the Amplience Media Delivery API, the URL-based API for Dynamic Media, covering image sizing, scaling, cropping, format and quality, adjustments, layers, metadata, sets, and video. keywords: - Dynamic Media - Media Delivery API - Amplience Dynamic Media - Dynamic Media parameters - image transformation API - image URL parameters audience: Developer date_published: 2026-07-12 date_modified: 2026-07-29 --- # Media Delivery API reference guide The Media Delivery API manipulates images, retrieves sets, and serves video via query parameters appended to Dynamic Media URLs, applied on the fly at delivery time. This quick reference lists every parameter and links to interactive examples. This page provides a quick reference followed by every parameter with interactive examples, split into sections. Every parameter can be appended to an asset's URL as a query string: **Base URL pattern** ```text https://cdn.media.amplience.net/{type}/{account}/{assetName}?{parameters} ``` > **Tip:** `type` identifies the asset kind (`i` for images, `s` for sets, `v` for video). See [URL structure](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-overview/#url-structure) in the overview for the full breakdown. Here's a simple example - rotate an image by 90°: ```uri https://cdn.media.amplience.net/i/ampproduct/two-friends-on-deck?rotate=90 ``` ## In this guide Parameters for resizing, cropping, converting and adjusting images, grouped by task below. ### [Sizing and scaling](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/) Resize with `w`, `h`, `maxW`, and `maxH`, then control what happens when the image does not fit the requested dimensions with scale modes, point of interest, and upscaling. [Sizing](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#sizing) · [`w`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#w) · [`h`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#h) · [`maxW`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#maxw) · [`maxH`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#maxh) · [Scale mode](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#scale-mode) · [`sm`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#sm) · [`sm=edge`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#sm-edge) · [`sm=clamp`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#sm-clamp) · [`scaleFit`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#scalefit) · [`poi`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#poi) · [`filter`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#filter) · [`upscale`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sizing-and-scaling/#upscale) ### [Cropping and rotation](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/) Crop a region or trim from the edges, before or after resizing, then rotate or flip. [`crop`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#crop) · [`ecrop`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#ecrop) · [`pcrop`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#pcrop) · [`pecrop`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#pecrop) · [`rotate`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#rotate) · [`protate`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#protate) · [`flip`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/cropping-and-rotation/#flip) ### [Format and quality](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/) Choose the output format, including automatic format selection, and tune compression globally, per format, or from platform defaults. [`qlt`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#qlt) · [`fmt`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#fmt) · [`fmt=auto`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#fmt-auto) · [`qlt=default`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#qlt-default) · [Per-format quality parameters](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#per-format-quality) · [`dpi`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#dpi) · [`dpiFilter`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#dpifilter) · [`strip`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#strip) · [`fmt.jpeg.chroma`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#fmt-jpeg-chroma) · [`fmt.jpeg.interlaced`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#fmt-jpeg-interlaced) · [PNG output options](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/format-and-quality/#png-output-options) ### [Image adjustments](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/) Colour space, sharpening, composite modes, background colour, blur, noise reduction, gamma, hue, saturation, and brightness. [`cs`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#cs) · [`unsharp`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#unsharp) · [`cm`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#cm) · [`cm=copy`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#cm-copy) · [`bg`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#bg) · [`blur`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#blur) · [`noiser`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#noiser) · [`gamma`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#gamma) · [`hue`, `sat`, `bri`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/image-adjustments/#hue-sat-bri) ### [Layers and text](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/) Composite images and text onto a base image, and control their position, anchor, opacity, and visibility. [Layers](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#layers) · [`src`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#layer-src) · [`top`, `left`, `bottom`, `right`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#layer-position) · [`anchor`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#anchor) · [`opacity`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#opacity) · [`visible`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#visible) · [`canvas`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#canvas) · [Text layers](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/layers/#text-layers) ### [Metadata](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/metadata/) Return an asset's metadata instead of the asset, filter which fields come back, and reference metadata values inside a query. [`metadata=true`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/metadata/#metadata-true) · [`metaFilter`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/metadata/#metafilter) · [Referencing metadata in queries](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/metadata/#metadata-tokens) ### [Variables and conditionals](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/variables-and-conditionals/) Build queries that adapt at request time using variables, conditionals, expressions, and a fallback image for missing assets. [`img404`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/variables-and-conditionals/#img404) · [`${variable}`](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/variables-and-conditionals/#variables) · [Conditionals](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/variables-and-conditionals/#conditionals) · [Expressions](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/variables-and-conditionals/#expressions) ### [Sets](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/) Return individual images from a set, retrieve set metadata in five formats, and use SEO-friendly set URLs. [Retrieving set images](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#retrieving-set-images) · [Return first element](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-first-element) · [Return nth element](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-nth-element) · [Return nested nth element](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-nested-element) · [Set metadata](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-metadata) · [JSONP format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-jsonp) · [JSON format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-json) · [XML format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-xml) · [Text format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-text) · [HTML format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#set-html) · [SEO and sets](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#seo-and-sets) ### [Video](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/) Request a transcode profile, generate thumbnails from a video, retrieve video metadata, and build HTML video embeds. [Serving video over HTTPS](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-https) · [Video thumbnails](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-thumbnails) · [Return poster frame](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-poster-frame) · [Return specified thumbnail](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-specified-thumbnail) · [Video metadata](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-metadata) · [JSONP format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-jsonp) · [JSON format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-json) · [XML format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-xml) · [Text format](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-text) · [Sitemap](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-sitemap) · [Generating HTML video embeds](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/video/#video-html-embeds) ### [SEO](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference/sets/#seo) SEO-friendly path segments can be appended to image URLs to improve search engine indexing. ## Accelerated Media {#accelerated-media} Accelerated Media is an optional add-on that unlocks the following features: - **Amplience Smart Images** - automatic format selection via `fmt=auto` - **AVIF format** - next-generation image compression - **VP9 and HEVC video codecs** To enable [Accelerated Media](https://amplience.com/developers/docs/dev-tools/guides-tutorials/media-delivery/accelerated-media/) on your account, contact your Account Manager. ## Related pages {#related-pages} - [Media Delivery API overview](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-overview/) - [Media Delivery quick reference](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-quick-reference/) - [Media cache settings](https://amplience.com/developers/docs/user-guides/assets/cache-purge#media-cache-settings) - [Video transcode profiles](https://amplience.com/developers/docs/user-guides/assets/video/#video-transcode-profiles) - [Working with video](https://amplience.com/developers/docs/user-guides/assets/video) - [Amplience Smart Images](https://amplience.com/developers/docs/dev-tools/guides-tutorials/media-delivery/smart-image)