Add-on API v2
Résoudre une image de groupe studio
Add-on API v2 — clés avec accès v2. Une image d'un groupe de studio : hero (prises de vue héroïques, certaines au niveau du sol), steered (roues avant tournées), extra (plus d'angles de trois hauteurs de caméra, coins également à 30° et 45°), drone (vues de dessus). Les groupes et leurs noms d'images sont expliqués sur *Groupe de studio : liste ses images*.
GET …/{trim} liste les groupes d'une voiture (groups), GET …/{trim}/{group} liste les images d'un groupe (views). Ensuite, résolvez-en une ici. Prend toutes les options d'image, y compris les options d'add-on (lights, background, couleur hex color, windows, plate, fit, size, hotspots).
Exemple: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, puis GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
brand obligatoire | chaîne | Nom de la marque (nomenclature du catalogue mise à jour pour les voitures supplémentaires). |
model obligatoire | chaîne | Nom du modèle. |
year obligatoire | entier | Année du modèle (4 chiffres). Si l'année exacte est manquante, la génération disponible la plus proche est utilisée (note d'erreur `Y01`). |
variant obligatoire | chaîne | Variante de carrosserie. |
trim obligatoire | chaîne | Niveau de finition |
group obligatoire | chaîne | Groupe studio: hero, steered, extra, drone (voir `groups` sur l'endpoint trim). |
image obligatoire | chaîne | Image du groupe (voir `views` du groupe). |
Paramètres de requête.
| Nom | Type | Description |
|---|---|---|
format | chaîne | Format de livraison. pngwebpjpegavifauto |
ratio | chaîne | Rapport hauteur/largeur. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | entier | Largeur en px. |
color | chaîne | Peinture: nom de couleur du catalogue ou hexadécimal à 6 chiffres. |
shadow | chaîne | Ombre au sol du studio. truefalse |
lights | chaîne | **Add-on API v2 :** phares allumés ou éteints (par défaut `off`). Non disponible pour une image → `off` + erreur `L26`. onoff |
background | chaîne | **Add-on API v2 :** `white` (par défaut), `transparent`, ou une couleur hexadécimale à 6 chiffres comme `f4f4f4`. Images studio uniquement (lifestyle → erreur `B32`). |
windows | chaîne | **Add-on API v2 :** `see_through` = vitrage comme dans l'image (par défaut), `dark` = vitrage teinté opaque. Non disponible → erreur `W28`. see_throughdark |
plate | chaîne | **Add-on API v2 :** plaque d'immatriculation — `none` = comme dans l'image (par défaut), `blank` = plaque vide, `logo` = votre logo sur la plaque (à configurer sur votre clé; manquant → blanc + erreur `N30`). noneblanklogo |
fit | chaîne | **Add-on API v2 :** comment la voiture remplit une boîte `ratio` / `size` — `contain` rembourre (par défaut), `cover` recadre. Les images lifestyle couvrent toujours. containcover |
size | chaîne | **Add-on API v2 :** côté le plus long — `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` prennent le pas sur `size`. 2k1080p720p540p360pthumb |
hotspots | chaîne | **Add-on API v2 :** ajouter `hotspots` à la réponse — points d'intérêt (jantes, phares, etc.) en fractions 0–1 de l'image, par exemple pour les visionneuses interactives. true |
