涂装颜色和效果

每辆车都可以涂成不同的颜色。颜色应用于实际的摄影棚拍摄 — 反射、铬合金、玻璃、徽章和内饰保持不变；只有油漆改变，符合其质感（实色油漆保持实色，金属油漆保持其依赖光线的变化）。

探索颜色

完整目录 — /api/colors。 每种活跃颜色，配对它所属的品牌：

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

每辆车 — 配置 /colors 端点。 简洁的颜色名称，故意保持简洁：房屋颜色加上该车品牌的颜色：

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

车身颜色与品牌颜色

• 自有色彩 (color_make: "Vehicleimagery")：white, silver, graphite, black, beige, brown, red, wine_red, orange, yellow, green, blue, dark_blue — 一系列精选的金属色，适用于每一款支持颜色的车辆，并列在每一款车的 /colors 中。
• 品牌色彩：原厂涂装（例如 Mercedes-Benz *Luganograu Metallic*）。它们在该品牌的车辆上有所列出 — 但 任何 活跃目录颜色都可以在 任何 车辆上请求。

请求颜色

将名称作为 ?color=（不区分大小写；URL编码空格）：

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

响应的settings.color回显应用的颜色；image_url交付重新上色的汽车。

与其他所有选项结合

颜色与每个其他交付选项结合：

?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

车身颜色（API v2附加功能）

在附加图片中，每种目录颜色都使用其真实的漆面：

十六进制颜色是光泽的，在前面加上一种效果，获得另一种效果：

?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 和 satin 可选第二个十六进制值作为效果颜色。响应显示漆面为 settings.paint；/api/options 列出漆面在 addon.options.color.finishes 下。

在附加工作室图片中，白色和其他浅色漆面显得明亮干净，即使没有 color；生活场景保留场景的光线。

备用

颜色请求永远不会硬失败：

• 未知的颜色名称→默认涂装，错误提示F04。
• 颜色不允许您的计划使用 → 默认车漆，错误说明 C09。
• color=default（或省略该参数） → 原厂车漆。

颜色适用于外观视图；内饰视图始终显示原始内饰。

性能

在第一次请求时生成重新上色，然后从 CDN 缓存中提供 — 重复请求是即时的，与其他所有转换完全相同。