पेंट कलर्स और फिनिश

हर कार को अलग-अलग पेंट कलर में डिलीवर किया जा सकता है। एक कलर को वास्तविक स्टूडियो शॉट पर लागू किया जाता है — परावर्तन, क्रोम, ग्लास, बैज और इंटीरियर अछूते रहते हैं; सिर्फ पेंट बदलता है, अपने फिनिश के अनुसार (सॉलिड पेंट सॉलिड रहते हैं, मेटालिक पेंट अपने लाइट-डिपेंडेंट फ्लॉप को बनाए रखते हैं)।

रंगों की खोज करें

पूर्ण कैटलॉग — /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 के बिना भी, लाइफस्टाइल दृश्यों में दृश्य की रोशनी बनी रहती है।

फॉलबैक

Color requests कभी भी hard fail नहीं होते:

• अज्ञात रंग का नाम → डिफ़ॉल्ट पेंट, त्रुटि नोट F04।
• Color आपकी प्लान द्वारा अनुमति नहीं → डिफ़ॉल्ट पेंट, errornote C09.
• color=default (या पैरामीटर को छोड़ना) → मूल रंग।

रंग बाहर के दृश्य पर लागू होते हैं; अंदर के दृश्य हमेशा मूल अंदरूनी दिखाते हैं।

प्रदर्शन

एक रीकलर पहले अनुरोध पर बनाया जाता है और फिर CDN केश से सर्व किया जाता है — दोहराए गए अनुरोध तत्काल होते हैं, हर दूसरे ट्रांसफॉर्म की तरह।