What is an image proxy?

An image proxy sits between your original image and the end user. Instead of delivering the full-resolution original, it transforms and optimizes the image on-the-fly based on URL parameters — delivering the right size, format, and quality for each device.

Which image formats are supported?

Fairu's Image Proxy supports JPEG, PNG, WebP, AVIF, GIF, and SVG as input formats. Output formats include WebP and JPEG with automatic format selection based on browser support.

How does focal point detection work?

When you crop an image to a different aspect ratio, the focal point determines which part of the image stays centered. Fairu's AI automatically detects the most important area (faces, subjects, text). You can also set a custom focal point manually via the focal parameter.

Is the Image Proxy included in all plans?

Yes, the Image Proxy is included in every Fairu plan — including the free trial. There are no extra fees for image transformations or delivery.

Can I use the Image Proxy for video files?

Yes. The Image Proxy automatically generates thumbnails from video files and supports HLS streaming for adaptive video delivery. You can request video thumbnails using the same URL parameter syntax as images.

How fast is the Image Proxy?

First requests are processed in under a second. All subsequent requests for the same transformation are served from cache in milliseconds. Cache invalidation happens within 60 seconds of any change.

What is an image proxy?

An image proxy sits between your original image and the end user. Instead of delivering the full-resolution original, it transforms and optimizes the image on-the-fly based on URL parameters — delivering the right size, format, and quality for each device.

Which image formats are supported?

Fairu's Image Proxy supports JPEG, PNG, WebP, AVIF, GIF, and SVG as input formats. Output formats include WebP and JPEG with automatic format selection based on browser support.

How does focal point detection work?

When you crop an image to a different aspect ratio, the focal point determines which part of the image stays centered. Fairu's AI automatically detects the most important area (faces, subjects, text). You can also set a custom focal point manually via the focal parameter.

Is the Image Proxy included in all plans?

Yes, the Image Proxy is included in every Fairu plan — including the free trial. There are no extra fees for image transformations or delivery.

Can I use the Image Proxy for video files?

Yes. The Image Proxy automatically generates thumbnails from video files and supports HLS streaming for adaptive video delivery. You can request video thumbnails using the same URL parameter syntax as images.

How fast is the Image Proxy?

First requests are processed in under a second. All subsequent requests for the same transformation are served from cache in milliseconds. Cache invalidation happens within 60 seconds of any change.

New Tiers availableMore feature, Up to 10 Million AI-Tokens for free

Read blog post

Image Proxy

The Fastest Way to Optimized Images

Transform, optimize, and deliver images in real-time via URL parameters. No preprocessing, no complexity.

Start for Free Documentation

How it works

From upload to optimized delivery in 3 steps

No build pipelines, no preprocessing, no configuration. Just upload your original and let the Image Proxy handle the rest.

Upload your original

Upload your full-resolution image to Fairu. We store the original safely — no quality loss, no compression at this stage.

Request via URL parameters

Add width, height, format, or quality parameters to the image URL. Each combination is generated on-the-fly and cached automatically.

Delivered optimized

The optimized variant is served instantly. Subsequent requests hit the cache — delivering in milliseconds with zero processing delay.

API-First

Simple URL Structure

Simply append parameters to the URL to transform images on-the-fly.

URL Structure

https://files.fairu.app/{UUID}/{filename}?width={INT}&height={INT}&focal_point={STRING}

// Example
https://files.fairu.app/9f8687a9-9a4e-4fd2-9cd8-73cc6cd51fd7/hero-image.jpg?width=800&height=600

Live demo

Try it yourself

Adjust the parameters and see the result in real-time. The URL updates automatically.

Width800px

Height

Auto

Quality85

Format

Focal point

Off

https://files.fairu.app/9fad6214-3c0e-4f02-a0dd-16e9d42d302b/demo.jpg?width=800

Image Transformations

Transform images in real-time via simple URL parameters — no preprocessing or complex configuration required.

Resize: Scale and crop images dynamically with width and height parameters.
Focal Point: AI automatically detects the focal point or set it manually with the focal parameter.
Format Conversion: Automatic conversion to WebP, AVIF, and modern formats.
Quality Control: Control compression with the quality parameter for optimal file size.

Performance

Built for speed at any scale

<60s

cache invalidation

WebP/AVIF

automatic format selection

quality loss at 85% compression

99.99%

uptime

Simple Control

URL Parameters

Control size, format, and quality of your images directly via URL parameters.

width

Set the width in pixels for proportional scaling.

?width=800

height

Set the height in pixels, combinable with width for exact cropping.

?width=800&height=600

focal

Define a custom focal point for smart cropping.

?width=300&height=300&focal=0-0-1

format

Convert to WebP, JPG, or PNG for optimal compression.

?format=webp

quality

Set compression quality (0-100). Recommended: 75-90.

?quality=85

version

For videos: Choose low, medium, or high compression.

?version=medium

Video Features

Not just images — the Fairu Proxy also optimizes video delivery with automatic thumbnails and HLS streaming.

Video Thumbnails: Automatically generated screenshots from videos, processable like regular images.
Compressed Versions: Access low, medium, or high compressed versions.
HLS Streaming: Enable HLS streaming for adaptive quality based on bandwidth.

Powerful Features

Why Fairu Image Proxy?

Everything you need for modern image delivery.

Smart Caching

Changes are reflected within 60 seconds, cached images delivered instantly via European edge servers.

CDN

Delivery via a European CDN for optimal performance and data sovereignty.

All File Types

Not just images — PDFs, Word documents, and videos are also optimized for delivery.

AI Optimization

AI-powered focal point detection for perfect image crops.

Easy Integration

Code Examples

Basic Resize

<!-- Resize to 800px width -->
<img src="https://files.fairu.app/{UUID}/image.jpg?width=800" />

<!-- Resize and crop to exact dimensions -->
<img src="https://files.fairu.app/{UUID}/image.jpg?width=400&height=300" />

Format & Quality

<!-- Convert to WebP with 85% quality -->
<img src="https://files.fairu.app/{UUID}/image.jpg?format=webp&quality=85" />

<!-- Optimized for thumbnails -->
<img src="https://files.fairu.app/{UUID}/image.jpg?width=150&quality=75" />

Focal Point

<!-- Custom focal point for smart cropping -->
<img src="https://files.fairu.app/{UUID}/portrait.jpg?width=300&height=300&focal=0-0-1" />

<!-- AI auto-detects focal point when not specified -->

Video Thumbnails & HLS

<!-- Get video thumbnail -->
<img src="https://files.fairu.app/{UUID}/video.mp4?width=800" />

<!-- HLS Streaming Playlist -->
https://fairu.app/hls/{UUID}/playlist.m3u8

FAQ

Frequently asked questions about Image Proxy

Related features

Ready for Lightning-Fast Images?

Start now and experience lightning-fast image delivery with the Fairu Image Proxy.

Start for Free Read Documentation

No credit card required

Free trial period

Cancel anytime