Cargoimg
Docs
Sign in

Studio images for every vehicle, on demand.

Request a DAF XF 2022, a Sprinter panel van, a passenger car — or any published make, model and year — in any color, with or without a studio shadow and a mapped EU plate. The API returns a signed image URL.

Invite-only · 9 studio views · median response under 200 ms

DAF XF 2022 · front_left · paint #C41E3A · studio shadow · plate AB-CD-123
daf/xf/2022front_left#C41E3Ashadow=trueAB-CD-123
Live request

One call. One signed URL.

GET /v1/makes/daf/models/xf/2022/front_left
curl -H "x-api-key: cimg_live_…" \
  "$APP_URL/v1/makes/daf/models/xf/2022/front_left?color=red&shadow=true&plate=AB-CD-123&format=webp"
200 OK · application/json
{
  "image_url": "https://cdn.cargoimg…/…webp?sig=…",
  "expires_in": 900,
  "width": 1600,
  "format": "webp",
  "warnings": []
}

The JSON is the product; fetch the URL for pixels. No image bytes cross the API boundary.

How it works

Three calls, no VIN lookups, no uploads from your side.

01

Walk the catalog

Make → model → year → view. Only published vehicles are listed, so a resolved path always renders.

/v1/makes → /models → /years → /views
02

Set the parameters

Paint color, studio shadow, EU plate, output format and pixel width. Defaults are production-safe.

?color=&shadow=&plate=&format=&width=
03

Get a signed URL

JSON in milliseconds. Hand the URL to your CDN, your listing page, or your configurator.

{ "image_url": "…", "warnings": [] }

Nine studio cameras

Every published vehicle is shot on the same rig, so views are consistent across your whole catalog.

9 views · same truck · same paint
front_left
front_left
front
front
front_right
front_right
side_right
side_right
rear_right
rear_right
rear
rear
rear_left
rear_left
side_left
side_left
top_down
top_down

Coverage

Heavy trucks are the deepest part of the catalog, but the same rig and the same nine cameras cover commercial and passenger classes alike.

5 classes · one parameter set

Trucks & tractor units

DAF XF, Volvo FH, Scania R — 4×2 and 6×2 configurations.

/v1/makes/daf/models/xf

Trailers & bodies

Curtainside, box, tipper and refrigerated bodies, shot solo.

/v1/makes/krone/models/profi-liner

Vans & light commercial

Panel vans, crew cabs, chassis cabs and dropside conversions.

/v1/makes/ford/models/transit

Passenger cars

Hatchback, estate and SUV bodies for marketplace listings.

/v1/makes/skoda/models/octavia

Buses & coaches

City buses and touring coaches, same paint and plate parameters.

/v1/makes/setra/models/s-515-hd

Paint & plate

Eight named colors for catalog consistency, or any hex when you need to match a customer's build.

color=
red
blue
green
white
black
silver
yellow
orange
or any hex — color=%23C41E3A
plate=

Plates are rendered as a generic EU design — blue band with stars, white field, black text — and mapped onto the vehicle's own plate surface. Unsupported geometry returns a PLATE_UNMAPPED warning, never an error.

EU
AB-CD-123
plate=AB-CD-123 · shadow=true
plate=AB-CD-123
no plate · shadow=false
plate omitted

For API teams

A developer product for imagery in listings, configurators and catalogs. Not a stock-photo site.

x-api-key

Header auth

One key per environment. No OAuth dance, no per-request signing on your side.

/v1/me

Quota, live

Current plan, remaining monthly volume and RPM ceiling in one call.

webp · png · jpeg

Formats

webp by default. png when you need transparency behind the vehicle.

200 – 2400 px

Width control

Default 1600. Ask for the exact size your grid renders — no client-side downscaling.

RPM + monthly

Contracted limits

Rate per minute plus a monthly volume, agreed in your contract. No metered surprises.

warnings[]

Soft degradation

SHADOW_UNAVAILABLE or PLATE_UNMAPPED come back with a usable image, not a 4xx.

Invite-only

Access is by invitation.

If you have an account, sign in. There is no public signup.