Options d'image
Couleurs et finitions de peinture
Chaque voiture peut être livrée dans différentes couleurs de peinture. Une couleur est appliquée à la prise de vue studio réelle — les reflets, le chrome, le verre, les badges et l'intérieur restent intacts; seule la peinture change, fidèle à sa finition (les peintures solides restent solides, les peintures métallisées conservent leur effet de changement de couleur selon la lumière).
Découvrez les couleurs
Le catalogue complet — /api/colors. Chaque couleur active, associée à la marque à laquelle elle appartient:
{ "colors": [
{ "color_name": "default", "color_make": "Vehicleimagery" },
{ "color_name": "wine_red", "color_make": "Vehicleimagery" },
{ "color_name": "Racing Red", "color_make": "Kia" }
] }
Par voiture — le point de terminaison /colors. Des noms de couleurs simples, volontairement concis: les couleurs de la maison plus les couleurs de la marque de cette voiture:
GET /api/Kia/Avella/1994/Basis/base/colors
→ { …, "colors": ["default", "Racing Red", "black", "blue", "orange", "white", "wine_red"] }
Couleurs maison vs. couleurs de marque
- Couleurs maison (
color_make: "Vehicleimagery"):white,silver,graphite,black,beige,brown,red,wine_red,orange,yellow,green,blue,dark_blue— une gamme métallisée soignée, disponible sur chaque voiture avec support de couleur et listée dans les couleurs de chaque voiture/colors. - Couleurs de marque: peintures d'origine du fabricant (par exemple, Mercedes-Benz *Luganograu Metallic*). Elles sont *listées* sur les voitures de cette marque — mais *toute* couleur de catalogue active peut être *demandée* sur *toute* voiture.
Demander une couleur
Passez le nom comme ?color= (insensible à la casse; encodez les espaces en URL):
GET /api/BMW/1/2004/Basis/base/front?color=wine_red
GET /api/BMW/1/2004/Basis/base/front?color=Racing%20Red
La réponse settings.color renvoie la couleur appliquée; image_url fournit la voiture repeinte.
Combinez avec tout le reste
Les couleurs s'associent à toutes les autres options de livraison:
?color=wine_red&shadow=true # painted + studio shadow
?color=wine_red&transparency=true&format=png # painted cut-out
?color=wine_red&format=webp&width=1200 # painted, WebP, 1200 px
?color=wine_red&mirroring=true # painted on the showroom floor
Finitions (add-on API v2)
Sur les images additionnelles, chaque couleur de catalogue est peinte avec sa finition réelle :
| Finition | Apparence |
|---|---|
solid | Peinture brillante |
metallic | Flancs plus foncés, reflets dans la couleur de l'effet, un fin scintillement |
pearl | Dégradé vers une deuxième couleur sur les bords |
satin | Brillant demi-mat |
matte | Pas de reflets |
chrome | Finition miroir dans la couleur |
aluminium | Métal poli |
carbon | Tissu visible sous la couche de finition |
Une couleur hexadécimale est brillante; placez une finition devant pour en obtenir une autre:
?color=c8102e # gloss
?color=metallic_315fbf # metallic, effect colour derived
?color=metallic_315fbf_5693f9 # metallic with your own effect colour
?color=matte_283b56 # matt_ works too
?color=satin_384a8c
?color=carbon_545454
?color=chrome_eac972
metallic, pearl et satin prennent une deuxième hex optionnelle pour la couleur de l'effet. La réponse affiche la finition sous settings.paint. /api/options liste les finitions sous addon.options.color.finishes
Sur les images studio additionnelles, les peintures blanches et autres teintes claires sont lumineuses et nettes, également sans un color; les scènes de style de vie conservent la lumière de la scène.
Images de secours
Les demandes de couleur ne échouent jamais:
- Nom de couleur inconnu → peinture par défaut, erreur
F04. - Couleur non autorisée par votre plan → peinture par défaut, erreur
C09. color=default(ou omission du paramètre) → la peinture d'origine.
Les couleurs s'appliquent aux vues extérieures; les vues intérieures montrent toujours l'intérieur d'origine.
Performance
Un relooking est produit à la première demande puis servi à partir du cache CDN — les demandes répétées sont instantanées, exactement comme toute autre transformation.

