एपीआई वी2 एड-ऑन
एक स्टूडियो ग्रुप इमेज को सुलझाएँ
API v2 add-on — keys with v2 access. एक छवि एक स्टूडियो समूह की: hero (हिरो शॉट्स, कुछ जमीन की ऊँचाई से), steered (आगे के पहिये मोड़े गए), extra (तीन कैमरे की ऊँचाई से और कोण, कोने भी 30° और 45° पर), drone (ऊपर से). समूह और उनकी छवि के नाम *स्टूडियो समूह: इसकी छवियाँ सूचीबद्ध करें* पर समझाए गए हैं।
GET …/{trim} एक कार के समूहों की सूची बनाता है (groups), GET …/{trim}/{group} एक समूह के इमेजों की सूची बनाता है (views). फिर एक इमेज को यहीं रिज़ॉल्व करें. हर इमेज ऑप्शन को लेता है, जिसमें एड-ऑन ऑप्शन भी शामिल हैं (lights, background, hex color, windows, plate, fit, size, hotspots).
उदाहरण: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, फिर GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
brand आवश्यक | string | ब्रांड का नाम (एड-ऑन कारों के लिए अपडेटेड कैटलॉग नामकरण). |
model आवश्यक | string | मॉडल का नाम |
year आवश्यक | पूर्णांक | मॉडल वर्ष (4-अंकीय)। अगर सही साल गायब है, तो निकटतम उपलब्ध जनरेशन का उपयोग किया जाता है (त्रुटि नोट `Y01`) |
variant आवश्यक | string | बॉडी वेरिएंट। |
trim आवश्यक | string | ट्रिम लेवल। |
group आवश्यक | string | स्टूडियो समूह: हीरो, स्टीयर्ड, एक्स्ट्रा, ड्रोन (ट्रिम एंडपॉइंट पर `groups` देखें) |
image आवश्यक | string | समूह का चित्र (समूह के `views` देखें) |
प्रश्न पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
format | string | डिलीवरी फॉर्मेट। pngwebpjpegavifauto |
ratio | string | आकार अनुपात. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | पूर्णांक | पिक्सेल में चौड़ाई। |
color | string | पेंट: कैटलॉग रंग का नाम या 6-डिजिट हेक्स. |
shadow | string | स्टूडियो ग्राउंड शैडो। truefalse |
lights | string | **API v2 add-on:** हेडलाइट्स ऑन या ऑफ (डिफ़ॉल्ट `off`). छवि के लिए उपलब्ध नहीं → `off` + त्रुटि नोट `L26`. onoff |
background | string | **API v2 add-on:** `white` (डिफ़ॉल्ट), `transparent`, या एक 6-डिजिट हेक्स रंग जैसे `f4f4f4`. स्टूडियो छवियाँ ही (लाइफस्टाइल → त्रुटि नोट `B32`). |
windows | string | **API v2 add-on:** `see_through` = ग्लास जैसा कि छवि में (डिफ़ॉल्ट), `dark` = प्राइवेसी ग्लास जिसे देखा नहीं जा सकता। उपलब्ध नहीं → त्रुटि नोट `W28`. see_throughdark |
plate | string | **API v2 add-on:** लाइसेंस प्लेट — `none` = छवि में जैसा (डिफ़ॉल्ट), `blank` = खाली प्लेट, `logo` = प्लेट पर आपका लोगो (की पर सेटअप; गायब → खाली + त्रुटि नोट `N30`). noneblanklogo |
fit | string | **API v2 add-on:** कार एक `ratio` / `size` बॉक्स को कैसे भरता है — `contain` पैड करता है (डिफ़ॉल्ट), `cover` काटता है। लाइफस्टाइल छवियाँ हमेशा कवर करती हैं। containcover |
size | string | **API v2 add-on:** सबसे लंबी ओर `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` `size` पर हावी होते हैं. 2k1080p720p540p360pthumb |
hotspots | string | **API v2 add-on:** `hotspots` को रिस्पॉन्स में जोड़ें — छवि के रीम्स, हेडलाइट्स जैसे बिंदु रुचि का हिस्सा 0–1 के रूप में, उदाहरण के लिए इंटरैक्टिव व्यूअर्स के लिए। true |
