Ready to get started?
Upload and manage any file type, create API keys, and explore analytics.
ImageCodex is a high-performance file and media delivery platform. Upload any file once, deliver it everywhere — with on-the-fly image transforms, named variants, path-based access, and multi-tenant support.
What you get
From upload to delivery, ImageCodex handles the heavy lifting so your app doesn’t have to.
Resize, crop, convert format and adjust quality via URL parameters. Images are processed on first request and cached automatically.
Every file is accessible by its original path, so folder structures are preserved. Static HTML, CSS, fonts, and any other assets work out of the box.
Define reusable presets like thumbnail, public, or og-image in config. Reference them by name — update once, applied everywhere.
Isolate files per site with scoped API keys, per-tenant storage buckets, and separate access analytics. One platform, many clients.
Issue scoped keys with fine-grained permissions (read, upload, delete), optional expiry, and per-key rate limiting.
Track request counts, last-accessed timestamps, and referrers per file — queryable from the dashboard or API.
How it works
Three steps from upload to your file in any app or browser.
POST any file to /v1/{siteId}/media with your API key. The file is stored securely and metadata is indexed.
Use the returned key (UUID) or the original filename path as the file identifier in any URL.
Append a named variant or dynamic parameters for images, or fetch the raw file directly by path. Responses stream with long-lived cache headers.
Example delivery URL
Delivery options
Use human-readable preset names or compose transforms on the fly with URL parameters.
Named variants (examples)
| Name | Description |
|---|---|
| thumbnail | Small preview, square crop |
| public | Optimised web delivery |
| og-image | Open Graph 1200×630 |
| original | Lossless original file |
Variants are fully customisable — name them anything and define any transform. See API docs for details.
Dynamic parameters
| Param | Description |
|---|---|
| w | Width in pixels |
| h | Height in pixels |
| fit | cover · contain · fill |
| format | webp · jpg · png |
| q | Quality 1–100 |
Example: /v1/site/media/key/w=880,h=495,fit=cover
Upload and manage any file type, create API keys, and explore analytics.