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 :

FinitionApparence
solidPeinture brillante
metallicFlancs plus foncés, reflets dans la couleur de l'effet, un fin scintillement
pearlDégradé vers une deuxième couleur sur les bords
satinBrillant demi-mat
mattePas de reflets
chromeFinition miroir dans la couleur
aluminiumMétal poli
carbonTissu 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.