Farbton und Finish

Jedes Auto kann in verschiedenen Lackfarben geliefert werden. Eine Farbe wird auf das eigentliche Studiofoto aufgetragen — Reflektionen, Chrom, Glas, Embleme und das Interieur bleiben unberührt; nur der Lack ändert sich, wahrheitsgetreu zu seiner Oberfläche (unifarbene Lacke bleiben unifarben, Metallic-Lacke behalten ihren lichtabhängigen Flop).

Entdecken Sie Farben

Der vollständige Katalog — /api/colors. Jede aktive Farbe, gepaart mit der Marke, zu der sie gehört:

{ "colors": [
  { "color_name": "default",    "color_make": "Vehicleimagery" },
  { "color_name": "wine_red",   "color_make": "Vehicleimagery" },
  { "color_name": "Racing Red", "color_make": "Kia" }
] }

Pro Auto — das Konfigurations-/colors-Endpoint. Einfache Farbnamen, bewusst kompakt: die Hausfarben plus die Farben der eigenen Marke des Autos:

GET /api/Kia/Avella/1994/Basis/base/colors
→ { …, "colors": ["default", "Racing Red", "black", "blue", "orange", "white", "wine_red"] }

Hausfarben vs. Markenfarben

• Hausfarben (color_make: "Vehicleimagery"): white, silver, graphite, black, beige, brown, red, wine_red, orange, yellow, green, blue, dark_blue: eine kuratierte Metallic-Linie, verfügbar bei jedem Auto mit Farbunterstützung und aufgeführt in den Farben jedes Autos unter /colors.
• Markenfarben: Originalfarben des Herstellers (z.B. Mercedes-Benz *Luganograu Metallic*). Sie sind bei Fahrzeugen dieser Marke *aufgeführt* — aber jede aktive Katalogfarbe kann bei jedem Auto *angefordert* werden.

Farbe anfordern

Geben Sie den Namen als ?color= an (Groß-/Kleinschreibung egal; Leerzeichen im URL-Format codieren):

GET /api/BMW/1/2004/Basis/base/front?color=wine_red
GET /api/BMW/1/2004/Basis/base/front?color=Racing%20Red

Der Wert von settings.color in der Antwort spiegelt die angewendete Farbe wider. image_url liefert das umlackierte Auto.

Kombinieren Sie mit allem anderen

Farben kombinieren sich mit jeder anderen Lieferoption:

?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

Abschlüsse (API v2 Add-on)

Auf Zusatzbildern ist jede Katalogfarbe in ihrer echten Lackierung lackiert:

Eine Hex-Farbe ist glänzend; stellen Sie ein Finish davor, um eine andere zu erhalten:

?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 und satin nehmen eine optionale zweite Hex für die Effektfarbe. Die Antwort zeigt die Lackierung als settings.paint. /api/options listet die Lackierungen unter addon.options.color.finishes auf.

Auf Zusatzstudiobildern sind weiße und andere helle Lackierungen hell und sauber, auch ohne ein color; Lifestyle-Szenen behalten das Licht der Szene.

Fallbacks

Farbwünsche scheitern nie hart:

• Unbekannter Farbname → Standardlackierung, Fehlerhinweis F04.
• Farbe nicht durch Ihren Plan erlaubt → Standardlackierung, Fehlerhinweis C09.
• color=default (oder das Parameter weglassen) → die Originalfarbe.

Farben gelten für Außenansichten. Innenansichten zeigen immer das ursprüngliche Interieur.

Performance

Eine Umfärbung wird bei der ersten Anfrage erstellt und dann aus dem CDN-Cache bereitgestellt — Wiederholungsanfragen sind sofort, genau wie jede andere Transformation.