Colores y acabados de pintura

Cada auto puede ser entregado en diferentes colores de pintura. Un color se aplica a la toma real del estudio — los reflejos, el cromo, el vidrio, las insignias y el interior permanecen intactos; solo la pintura cambia, fiel a su acabado (las pinturas sólidas permanecen sólidas, las pinturas metálicas conservan su cambio dependiente de la luz).

Descubre colores

El catálogo completo — /api/colors. Cada color activo, emparejado con la marca a la que pertenece:

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

Por coche — el punto final /colors. Nombres de colores simples, deliberadamente compactos: los colores de la casa más los colores de la propia marca del coche:

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

Colores de la casa frente a colores de la marca

• House colors (color_make: "Vehicleimagery"): white, silver, graphite, black, beige, brown, red, wine_red, orange, yellow, green, blue, dark_blue — a curated metallic line, available on every car with color support and listed in every car's /colors.
• Colores de marca: pinturas originales del fabricante (por ejemplo, Mercedes-Benz *Luganograu Metallic*). Están *listados* en los coches de esa marca, pero cualquier color de catálogo activo puede ser *solicitado* en cualquier coche.

Solicitar un color

Pase el nombre como ?color= (sin distinguir mayúsculas y minúsculas; codificar espacios en URL):

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

El settings.color de la respuesta refleja el color aplicado; image_url entrega el coche repintado.

Combínalo con todo lo demás

Los colores se combinan con todas las demás opciones de entrega:

?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

Finalizaciones (complemento de API v2)

En las imágenes adicionales cada color de catálogo se pinta con su acabado real:

Un color hexadecimal es brillante; pon un acabado delante para otro:

?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 y satin aceptan un segundo hex opcional para el color del efecto. La respuesta muestra el acabado como settings.paint. /api/options lista los acabados bajo addon.options.color.finishes.

En las imágenes de estudio adicionales los colores blancos y otros claros se muestran brillantes y limpios, también sin un color; las escenas de estilo de vida mantienen la luz de la escena.

Fallbacks

Las solicitudes de color nunca fallan:

• Nombre de color desconocido → pintura por defecto, nota de error F04.
• Color no permitido por tu plan → pintura predeterminada, errornote C09.
• color=default (o omitir el parámetro) → la pintura original.

Los colores se aplican a las vistas exteriores; las vistas interiores siempre muestran el interior original.

Rendimiento

Un recoloreo se produce en la primera solicitud y luego se sirve desde la caché del CDN — las solicitudes repetidas son instantáneas, exactamente como cualquier otra transformación.