AeroModel
Documentation
width
Canvas width in pixels. Mutually exclusive with resolution.
Range
- Min:
256 - Max:
4096 - Default:
1280 - Type: integer
Out-of-range → 400 Bad Request (in format=json) or silent clamping (in image mode).
API examples
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&width=512
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&width=1280
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&width=2400
width=512 | width=1280 | width=2400 |
|---|---|---|
 |  |  |
When to prefer width over resolution
- Very specific width: a fixed 920 px container →
width=920. - Precise offline generation (printing, print).
Otherwise prefer resolution which:
- Has canonical values shared between clients (better cache hit ratio).
- Doesn't break the cache if you change your design.
Height?
The API does not expose height separately. Height is derived from width while preserving the source asset aspect ratio. To force a frame, use zoomType=fill + zoomLevel.
Errors
| Case | Response |
|---|---|
width=100 | 400 width must be an integer between 256 and 4096 |
width=foo | 400 |
width=1024&resolution=card | 400 resolution and width cannot be combined |