API v2 Add-on

Studio-Gruppe: Liste ihre Bilder

Holen/api/{brand}/{model}/{year}/{variant}/{trim}/hero

API v2 Add-on — Schlüssel mit v2-Zugang. Die Bilder einer Studio-Gruppe. hero steht für jede Studio-Gruppe des Autos. Welche ein Auto hat, steht in groups auf dem Trim-Endpoint.

| Gruppe | Was gezeigt wird | Bildnamen (Beispielauto) | |---|---|---| | hero | Heldenshots: Dreiviertelansichten, einige aus Bodennähe aufgenommen | front_left, front_left_ground, front_right, front_right_ground, left_ground, rear_left, rear_right, right_ground (8) | | steered | Vorderräder eingeschlagen, aus drei Kamerahöhen | front_left, front_left_eye, front_left_high, front_left_low, front_right, … (8) | | extra | Weitere Winkel: jede Seite und Ecke aus drei Kamerahöhen, Ecken auch bei 30° und 45° | front_eye, front_high, front_low, front_left_30, front_left_30_eye, front_left_45_high, rear_right_45_low, left_eye … (56) | | drone | Von oben: schräge Aufnahmen, steile Ansichten und gerade von oben | front_left, front_right, front_steep, rear_left, rear_right, rear_steep, top (7) |

Bildnamen werden aus der Perspektive (front, front_left, left, rear_right …) plus Endungen gebildet: _eye = Augenhöhe, _high = Kamera von oben, _low = Kamera tief, _ground = auf Bodenhöhe, _30 / _45 = Eckansicht bei 30° / 45°, _steep = steil von oben, top = von oben direkt nach unten. Die genaue Liste pro Auto ist immer in views dieses Endpunkts.

Wählen Sie ein Bild aus views und lösen Sie es mit *Resolve a studio group image* auf, z.B. GET /api/Audi/Q9/2026/SUV/Default/hero/front_left

Pfadparameter

NameTypBeschreibung
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.