Image
Résolvez une URL d'image signée
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
Le point de terminaison principal. Renvoie les métadonnées plus une image_url signée que vous intégrez directement dans un <img>.
Ajoutez n'importe quelle option en tant que paramètre de requête. Tout ce qui n'est pas disponible pour la voiture ou non autorisé par votre plan revient à la valeur valide la plus proche et est rapporté dans errornotes (plutôt que de ne pas fonctionner).
Exemples
?format=webp&width=1200— WebP, 1200 px de large.?ratio=16:9&format=jpeg— rembourré à 16:9.?mirroring=true— voiture sur un sol de showroom réfléchissant.?transparency=true&format=png— découpe sur fond transparent.?color=wine_red— repeint dans la couleur maison wine_red.?color=Racing%20Red&shadow=true— peinture de catalogue Kia plus ombre studio.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
brand obligatoire | chaîne | Nom de marque ou alias (insensible à la casse). |
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 |
view obligatoire | chaîne | Nom de la vue - voir /api/views (ex. front, front_left, rear). |
Paramètres de requête.
| Nom | Type | Description |
|---|---|---|
format | chaîne | Format de livraison. `auto` choisit WebP. Original est PNG. pngwebpjpegavifauto |
resolution | chaîne | Préréglage de taille/qualité (remplacé par la largeur/qualité explicite). defaultthumbsmallmediumlargefull |
ratio | chaîne | Remplir pour un rapport d'aspect. `default` = natif. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | entier | Largeur explicite en px (arrondie à l'échelle de largeur). |
height | entier | Hauteur explicite en px. |
quality | entier | Qualité de l'encodeur (40–100). |
color | chaîne | Couleur de peinture par nom (insensible à la casse; encodez les espaces en URL, par exemple `Racing%20Red`). La voiture est repeinte à la demande, finition vraie, reflets et garnitures préservés. Les couleurs d'une voiture `/colors` listent son ensemble affiché (couleurs maison + couleurs de sa marque); toute couleur active de `/api/colors` peut être demandée. Couleur inconnue → peinture par défaut + note d'erreur `F04`. Se combine avec toutes les autres options. |
shadow | chaîne | Ombre au sol du studio — rendue au moment de la livraison, disponible pour chaque vue extérieure. Avec `mirroring=true` cela contrôle l'ombre sous le véhicule à la place. truefalse |
transparency | chaîne | Fond transparent découpé — disponible pour chaque vue extérieure (utiliser avec PNG/WebP). truefalse |
ground | chaîne | Placez la voiture au sol (nécessite une variante transparente). true |
mirroring | chaîne | Sol réfléchissant. `true` = avec ombre sous la carrosserie, `clean` = réflexion seulement. Nécessite une variante transparente. trueclean |
