Add-on API v2

Groupe studio : lister ses images

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

Add-on API v2 — clés avec accès v2. Les images d'un groupe de studio. hero désigne tout groupe de studio de la voiture. Les groupes qu'une voiture possède sont dans groups sur l'endpoint trim.

| Groupe | Ce qu'il montre | Noms des images (exemple voiture) | |---|---|---| | hero | Vues d'héro: trois quarts, certaines prises au ras du sol | front_left, front_left_ground, front_right, front_right_ground, left_ground, rear_left, rear_right, right_ground (8) | | steered | Roues avant tournées, vues de trois hauteurs de caméra | front_left, front_left_eye, front_left_high, front_left_low, front_right, … (8) | | extra | Plus d'angles: chaque côté et coin de trois hauteurs de caméra, coins également à 30° et 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 | Vue du dessus: prises de vue inclinées, vues en plongée et vues de dessus | front_left, front_right, front_steep, rear_left, rear_right, rear_steep, top (7) |

Les noms des images sont construits à partir du côté (front, front_left, left, rear_right …) plus des suffixes: _eye = au niveau des yeux, _high = caméra au-dessus, _low = caméra basse, _ground = au niveau du sol, _30 / _45 = vue en coin à 30° / 45°, _steep = vue en plongée, top = vue de dessus. La liste exacte par voiture se trouve toujours dans views de cet endpoint.

Choisissez une image parmi views et résolvez-la avec *Résoudre une image de groupe studio*, par exemple GET /api/Audi/Q9/2026/SUV/Default/hero/front_left

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

Demande

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/hero" \
  -H "x-api-key: YOUR_API_KEY"

200 · Images du groupe.

[
  {
    "id": 900000003,
    "brand": "Audi",
    "model": "Q9",
    "year": 2026,
    "variant": "SUV",
    "trim": "Default",
    "group": "hero",
    "resolution": "default",
    "format": "png",
    "views": {
      "front_left": true,
      "front_left_ground": true,
      "front_right": true,
      "front_right_ground": true,
      "rear_left": true,
      "rear_right": true
    }
  }
]

401 · Clé `x-api-key` manquante ou invalide.

{
  "error": "Invalid API key"
}

403 · Restriction de plan (fonctionnalité, format ou marque non autorisés) ou demande bloquée.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · Aucune donnée pour le chemin demandé.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}