Cores e acabamentos de pintura

Qualquer carro pode ser entregue em diferentes cores de tinta. Uma cor é aplicada à foto real do estúdio — reflexos, cromados, vidros, emblemas e o interior permanecem intactos; apenas a tinta muda, fiel ao seu acabamento (tintas sólidas permanecem sólidas, tintas metálicas mantêm seu flop dependente da luz).

Descubra as cores

O catálogo completo — /api/colors. Todas as cores ativas, emparelhadas com a marca a que pertencem:

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

Por carro — o endpoint /colors. Nomes de cores simples, deliberadamente compactos: as cores da casa mais as cores da própria marca do carro:

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

Cores da casa vs. cores da marca

• Cores da casa (color_make: "Vehicleimagery"): white, silver, graphite, black, beige, brown, red, wine_red, orange, yellow, green, blue, dark_blue — uma linha metálica curada, disponível em todos os carros com suporte de cor e listada em cada carro's /colors.
• Cores da marca: tintas originais do fabricante (por exemplo, Mercedes-Benz *Luganograu Metallic*). Elas são *listadas* nos carros dessa marca, mas qualquer cor ativa do catálogo pode ser *solicitada* em qualquer carro.

Solicitar uma cor

Passe o nome como ?color= (sem diferenciação entre maiúsculas e minúsculas; codifique espaços em URL):

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

O settings.color da resposta reflete a cor aplicada; image_url entrega o carro repintado.

Combine com tudo o mais

As cores combinam com todas as outras opções 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

Acabamentos (complemento da API v2)

Nas imagens adicionais, cada cor do catálogo é pintada com seu acabamento real:

Uma cor hexadecimal é brilhante; coloque um acabamento na frente dela para outra opção:

?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 e satin aceitam um segundo hex opcional para a cor do efeito. A resposta mostra o acabamento como settings.paint. /api/options lista os acabamentos sob addon.options.color.finishes

Nas imagens de estúdio adicionais, as tintas brancas e outras claras são mostradas brilhantes e limpas, também sem um color; cenas de estilo de vida mantêm a luz da cena.

Fallbacks

Pedidos de cor nunca falham de forma crítica:

• Nome de cor desconhecido → pintura padrão, erro F04.
• Cor não permitida pelo seu plano → pintura padrão, nota de erro C09.
• color=default (ou omitindo o parâmetro) → a pintura original.

As cores aplicam-se a vistas exteriores; as vistas interiores mostram sempre o interior original.

Desempenho

Uma recorrência é produzida na primeira solicitação e depois servida a partir do cache CDN — solicitações repetidas são instantâneas, exatamente como qualquer outra transformação.