resolution
Width preset. Mutually exclusive with width.
Values
| Preset | Width (px) | Typical use case |
|---|
thumb | 512 | Thumbnails, lists, mobile |
card | 1024 | Cards, product sheets |
hd | 2048 | Hero sections, Retina displays |
ultra | 4096 | Print, user zoom |
API examples
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&resolution=thumb
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&resolution=card
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&resolution=hd
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&resolution=ultra
thumb 512 | card 1024 | hd 2048 | ultra 4096 |
|---|
 |  |  |  |
Why prefer presets
- Cache hit ratio: every client wanting a "card" hits the same URL → a single cache slot.
- Stable over time: if we remap
card to 1100 px tomorrow (to match a new design), your URLs don't change.
- Shorter:
?resolution=hd < ?width=2048.
Approximate PNG sizes
| Preset | Typical PNG size |
|---|
thumb | 30-80 KB |
card | 80-200 KB |
hd | 200-600 KB |
ultra | 800 KB-2 MB |
WebP: ~50% lighter. JPG: ~70% lighter (no alpha).
Errors
| Case | Response |
|---|
resolution=xxl | 400 resolution must be one of thumb, card, hd, ultra |
resolution=hd&width=2048 | 400 resolution and width cannot be combined |
See also
