API v2 Add-on
Studio group image by id
GET/api/id/{id}/{group}/{image}
API v2 add-on — keys with v2 access. Same as *Resolve a studio group image*, addressed by the car's stable id instead of its names. GET /api/id/{id}/{group} lists the images of a group. Cars that exist only in the add-on have ids from 900000000.
Path parameters
| Name | Type | Description |
|---|---|---|
id required | integer | Stable config id. |
group required | string | Studio group: hero, steered, extra, drone. |
image required | string | Image of the group. |
Query parameters
| Name | Type | Description |
|---|---|---|
format | string | Delivery format. pngwebpjpegavifauto |
color | string | Paint: catalog colour name or 6-digit hex. |
lights | string | **API v2 add-on:** headlights on or off (default `off`). Not available for an image → `off` + errornote `L26`. onoff |
background | string | **API v2 add-on:** `white` (default), `transparent`, or a 6-digit hex colour like `f4f4f4`. Studio images only (lifestyle → errornote `B32`). |
windows | string | **API v2 add-on:** `see_through` = glass as in the image (default), `dark` = privacy glass you cannot see through. Not available → errornote `W28`. see_throughdark |
plate | string | **API v2 add-on:** licence plate — `none` = as in the image (default), `blank` = empty plate, `logo` = your logo on the plate (set up on your key; missing → blank + errornote `N30`). noneblanklogo |
fit | string | **API v2 add-on:** how the car fills a `ratio` / `size` box — `contain` pads (default), `cover` crops. Lifestyle images always cover. containcover |
size | string | **API v2 add-on:** longest side — `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` win over `size`. 2k1080p720p540p360pthumb |
hotspots | string | **API v2 add-on:** add `hotspots` to the response — points of interest (rims, headlights …) as fractions 0–1 of the image, e.g. for interactive viewers. true |
