API v2 Add-on
Eine Studio-Gruppen-Bild auflösen
API v2 Add-on — Schlüssel mit v2-Zugang. Ein Bild einer Studio-Gruppe: hero (Hauptaufnahmen, einige vom Boden aus), steered (Vorderräder eingeschlagen), extra (mehr Winkel aus drei Kamerahöhen, Ecken auch bei 30° und 45°), drone (aus der Vogelperspektive). Die Gruppen und ihre Bildnamen werden unter *Studio-Gruppe: Liste ihrer Bilder* erklärt.
GET …/{trim} listet die Gruppen eines Autos auf (groups), GET …/{trim}/{group} listet die Bilder einer Gruppe auf (views). Dann lösen Sie eines hier auf. Es werden alle Bildoptionen berücksichtigt, einschließlich der Add-on-Optionen (lights, background, hex color, windows, plate, fit, size, hotspots).
Beispiel: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, dann GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
brand erforderlich | Zeichenkette | Brand name (aktualisierte Katalogbezeichnung für Add-on-Fahrzeuge). |
model erforderlich | Zeichenkette | Modellname. |
year erforderlich | Ganzzahl | Modelljahr (4-stellig). Wenn das genaue Jahr fehlt, wird die nächste verfügbare Generation verwendet (Fehlermeldung `Y01`). |
variant erforderlich | Zeichenkette | Karosserie-Variante. |
trim erforderlich | Zeichenkette | Ausstattungsvarianten. |
group erforderlich | Zeichenkette | Studio-Gruppen: hero, gelenkt, extra, Drohne (siehe `groups` auf dem Trim-Endpunkt). |
image erforderlich | Zeichenkette | Bild der Gruppe (siehe `views` der Gruppe). |
Abfrageparameter.
| Name | Typ | Beschreibung |
|---|---|---|
format | Zeichenkette | Auslieferungsformat. pngwebpjpegavifauto |
ratio | Zeichenkette | Seitenverhältnis. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | Ganzzahl | Breite in px. |
color | Zeichenkette | Lack: Katalogfarbname oder 6-stellige Hex. |
shadow | Zeichenkette | Studio-Schattenschatten. truefalse |
lights | Zeichenkette | **API v2 add-on:** Scheinwerfer an oder aus (Standard `off`). Nicht verfügbar für ein Bild → `off` + Fehlerhinweis `L26`. onoff |
background | Zeichenkette | **API v2 add-on:** `white` (Standard), `transparent` oder eine 6-stellige Hex-Farbe wie `f4f4f4`. Nur Studiobilder (Lifestyle → Fehlerhinweis `B32`). |
windows | Zeichenkette | **API v2 add-on:** `see_through` = Glas wie im Bild (Standard), `dark` = getönte Scheiben, durch die man nicht hindurchsehen kann. Nicht verfügbar → Fehlerhinweis `W28`. see_throughdark |
plate | Zeichenkette | **API v2 add-on:** Kennzeichen — `none` = wie im Bild (Standard), `blank` = leeres Kennzeichen, `logo` = Ihr Logo auf dem Kennzeichen (in Ihrem Schlüssel eingerichtet; fehlt → leer + Fehlerhinweis `N30`). noneblanklogo |
fit | Zeichenkette | **API v2 add-on:** wie das Auto ein `ratio` / `size` Feld füllt — `contain` füllt auf (Standard), `cover` schneidet ab. Lifestyle-Bilder decken immer ab. containcover |
size | Zeichenkette | **API v2 Add-on:** längste Seite `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` übersteigen `size`. 2k1080p720p540p360pthumb |
hotspots | Zeichenkette | **API v2 add-on:** `hotspots` zur Antwort hinzufügen — Interessante Punkte (Felgen, Scheinwerfer …) als Brüche 0–1 des Bildes, z.B. für interaktive Betrachter. true |
