Usage
Reference
Supported formats, error codes, and quick lookup tables
Supported Input Formats
| Format | Transformable | Notes |
|---|---|---|
| JPEG | Yes | Most common product image format |
| PNG | Yes | Supports transparency |
| WebP | Yes | Modern format, good compression |
| GIF | Returned as-is | Animated GIFs are not re-encoded |
| TIFF | Yes | Converted to requested output format |
| SVG | Returned as-is | Vector — no raster transformation |
| Returned as-is | Served with correct MIME type |
Error Responses
| Status | Condition | Response |
|---|---|---|
304 | If-None-Match matches ETag | Empty body (use cached version) |
400 | Invalid parameters (e.g. fit without both dimensions) | INVALID_PARAMETERS |
404 | Image not found in storage | Branded HTML 404 page |
422 | Unprocessable transform (e.g. corrupt image) | INVALID_PARAMETERS |
504 | Transform timeout (30s limit) | TIMEOUT |
Image bomb protection: Images exceeding 100 megapixels are rejected to prevent memory exhaustion.