Features

Catalog

• 31 aircraft models (Airbus A220 → A380, Boeing 737 → 787) with technical data (length, wingspan, capacity).
• ~1500 airline liveries pre-rendered, regularly updated.
• Special liveries (retro, partnerships, events) for major airlines.
• Blank aircraft (blank) available for every model, useful for mockups.

Flexible resolution

Auto-detection on the main param (plane, airline) or strict on _iata / _icao. See plane, airline.

Rendering

• 10 canonical angles: 0 (front), 45, 90 (right profile), 135, 180 (tail), 225, 270 (left profile), 315, 345 (3/4 front), top (top-down view).
• Landing gear: gear=down|up.
• 3 formats: png (alpha), jpg (opaque), webp.
• Free width (width=256-4096) or 4 presets (thumb, card, hd, ultra).
• Framing: zoomType=contain|fill, zoomLevel=0.5-3, marginPercent=0-45.

On-the-fly composition

The Worker can dynamically compose:

• Pitch: number in degrees -45..45 (nose-up / nose-down). See pitch.
• Vertical alignment: align=bottom|center|top to align fleets on a common baseline. See align.
• Relative scale: scale=fleet sizes multiple aircraft to the same real-world scale, ideal for fleet comparisons. See scale.
• Solid background: background=%23001a33. See background.
• Linear gradient background: backgroundGradient=linear:90:%23001a33-0,%23003366-1. See backgroundGradient.

When any composition parameter is used, the output is forced to PNG (header x-format-coerced: png).

Smart fallbacks

A request almost never returns 404 on the image endpoint. The cascade:

1. Requested livery
2. Airline base livery
3. blank (aircraft without livery)
4. default/base.jpg

The x-fallback-reason header documents the choice. See Errors and fallbacks.

Performance

• Cloudflare edge cache: ~30 ms on cache hit, anywhere in the world.
• Versioned manifest: cache invalidates automatically on every asset rebuild.
• No on-the-fly rendering on the hot path: every angle + format is pre-generated.

See Edge cache.

Introspection mode

format=json returns resolution metadata without downloading the binary image. Ideal for debugging, tests, and client-side pre-validation. See format.

Utility endpoints

• /v1/catalog/planes — search aircraft
• /v1/catalog/airlines — search airlines (filter by aircraft)
• /v1/catalog/liveries — liveries available for Plane × Airline
• /v1/info/planes/{slug} — aircraft datasheet
• /v1/info/airlines/{slug} — airline datasheet
• /v1/assets/airline-logo/{slug} — airline logo proxy
• /v1/assets/manufacturer-logo/{slug} — manufacturer logo proxy
• /v1/resolve — generic resolution
• /v1/health — Worker status

Security

• API key auth (x-api-key header, ?api-key= URL, or Authorization: Bearer).
• TLS required (https://).
• No PII collected. Standard Cloudflare logs.