Цвета краски и покрытия

Каждый автомобиль может быть представлен в разных цветах краски. Цвет наносится на реальный студийный снимок — отражения, хром, стекло, эмблемы и интерьер остаются нетронутыми; меняется только краска, соответствующая её отделке (матовые краски остаются матовыми, металлические сохраняют свой светозависимый эффект).

Откройте для себя цвета

Полный каталог — /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 — повторные запросы мгновенны, как и любое другое преобразование.