IMAGE PROCESSING · ON THE FLY

On-the-Fly Image Processing

Your Anycast CDN generates, caches and delivers image variants on request, while your origin keeps a single master file. Ask for a size in the URL and the edge does the rest.

Powered by the imgproxy processing server · Generated variants are cached at the edge like any other object · Engineer reply within 3 business hours

4 presets

crop, resize, resizefit and resizefill

1 file

One master on your origin, every size at the edge

The processing itself is not billed

One image, every size

Your origin stores one file. The CDN generates, caches and delivers every variant from a query string on your own domain.

Source file, 1376 x 768

resizefit, width 800

resizefit, width 480

				
					https://cdn.example.com/images/photo.jpg?preset=resizefill&width=1200&height=1000

How a request works

Ask for a variant in the URL. The CDN generates it once, caches it at the edge and serves every later request from there.

				
					https://<cdn-domain>/<image-path>?preset=<preset-name>&<preset-parameters>

Host

Your CDN domain: the deployed server, domain or IP that answers the request.

Image path

Where the original lives on your origin or bucket. The master file itself is never modified.

Processing options

The preset name and its parameters, passed as query-string pairs separated by ampersands.

Example: ?preset=resizefill&width=800&height=600 returns a copy of the image that fills an exact 800 x 600 box. If the source has a different aspect ratio, it is scaled and then cropped, so the output always has the dimensions you asked for.

PRESETS

Four presets, one query string

A preset maps a name you choose to imgproxy processing functions and the parameters they need. These four are available in the user panel today.

crop

Crops an image to a specific size and anchor position.
crop:$arg_width:$arg_height:$arg_gravity

resize

Resizes an image using a selected resize mode.
resize:$arg_type:$arg_width:$arg_height

resizefit

Resizes an image to fit within the requested dimensions.
resize:fit:$arg_width:$arg_height

resizefill

Resizes and crops an image to fill the requested dimensions.
resize:fill:$arg_width:$arg_height

Turn it on per location

Image Processing is switched on for a resource location, not for the whole account, so you decide where variants are generated.

Open your resource

In the user panel, open the CDN resource that serves your images.

Locations tab

Click Image Processing to enable the parameter. The configuration page unfolds right there.

Request a size

Add a preset and its parameters to any image URL on your CDN domain. The first request generates the variant, the rest are served from cache.

What 100 TB of delivered traffic costs

Progressive tiers work like tax brackets: each rate applies only to the traffic inside its range. Requests, HTTPS, custom domains, origin shield and image processing on imgproxy are included, and the rate is the same in Europe, Asia and America.

TIER 01

First 5 TB

$5.00 per TB

TIER 02

5 to 25 TB

$4.50 per TB

TIER 03

25 to 100 TB

$4.00 per TB

100 TB a month works out at $415

Each tier is billed only on the traffic inside it, so the tiers add up rather than replace each other. 25 TB is about $115, 500 TB is about $1,815, and above 500 TB a month we quote it for you.