Guide
URL Pattern
Transform images using Repix's intuitive URL pattern.
Pattern
Repix uses a simple URL pattern for image transformations:
https://your-domain.com/{preset|rules}/{url-without-prefix}
- preset — A named preset from your config (e.g.,
thumbnail,banner) - rules — Inline transformation parameters (e.g.,
w=400,h=300,fit=cover) - url-without-prefix — The source image URL without
https://(Repix adds it)
Examples
Using Presets
https://your-domain.com/thumbnail/example.com/images/photo.jpg
https://your-domain.com/avatar/cdn.example.com/users/123/profile.png
https://your-domain.com/banner/assets.example.com/hero-bg.jpg
Using Direct Rules
When allowCustomTransforms is enabled:
https://your-domain.com/w=400,h=300,fit=cover/example.com/photo.jpg
https://your-domain.com/w=800,f=webp,q=90/example.com/photo.jpg
https://your-domain.com/w=200,h=200,fit=cover,f=avif,q=85/example.com/photo.jpg
cURL Example
curl -o output.webp "https://your-repix.com/w=400,h=300,fit=cover,f=webp,q=85/example.com/path/to/image.jpg"
API Endpoints
| Endpoint | Description |
|---|---|
GET / | Service info and available endpoints |
GET /health | Health check |
GET /presets | List available presets |
GET /:transform/* | Transform and serve image |
GET /original/* | Serve source image without processing (when enabled) |