चित्र
एक साइन किया गया इमेज URL सुलझाएँ
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
कोर एंडपॉइंट। एक साइन किया हुआ image_url वापस करता है जिसे आप सीधे एक <img> में एम्बेड करते हैं, साथ ही मेटाडेटा भी।
कोई भी विकल्प को एक क्वेरी पैरामीटर के रूप में जोड़ें। अगर कार के लिए उपलब्ध नहीं है या आपकी प्लान द्वारा अनुमति नहीं है, तो सबसे करीबी वैध मान पर फॉलबैक होता है और errornotes में रिपोर्ट किया जाता है (फेल होने के बजाय)
उदाहरण
?format=webp&width=1200— WebP, 1200 px चौड़ा.?ratio=16:9&format=jpeg— 16:9 तक फैलाया गया.?mirroring=true— एक प्रतिबिंबित शोरूम फ्लोर पर कार.?transparency=true&format=png— पारदर्शी पृष्ठभूमि पर कटआउट.?color=wine_red— wine_red रंग में रंगी गई.?color=Racing%20Red&shadow=true— Kia catalog paint plus studio shadow.
API v2 add-on: for cars with add-on images the extra options below apply (lights, background, hex color, windows, plate, fit, size, hotspots), e.g. ?color=c8102e&windows=dark&size=1080p. With the add-on {view} can also be a studio group (hero, steered, extra, drone): that lists the group's images — see *API v2 Add-on*.
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
brand आवश्यक | string | ब्रांड का नाम या एलियास (केस-इन्सेंसिटिव)। |
model आवश्यक | string | मॉडल का नाम |
year आवश्यक | पूर्णांक | मॉडल वर्ष (4-अंकीय)। अगर सही साल गायब है, तो निकटतम उपलब्ध जनरेशन का उपयोग किया जाता है (त्रुटि नोट `Y01`) |
variant आवश्यक | string | बॉडी वेरिएंट। |
trim आवश्यक | string | ट्रिम लेवल। |
view आवश्यक | string | व्यू नाम देखें /api/views (उदाहरण के लिए, फ्रंट, फ्रंट_लेफ्ट, रियर)। |
प्रश्न पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
format | string | प्राप्ति प्रारूप। `auto` WebP चुनता है। मूल PNG है। pngwebpjpegavifauto |
resolution | string | आकार/गुणवत्ता प्रीसेट (स्पष्ट चौड़ाई/गुणवत्ता द्वारा ओवरराइड किया जाता है). defaultthumbsmallmediumlargefull |
ratio | string | एक एस्पेक्ट रेशियो तक पैड करें। 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | पूर्णांक | चौड़ाई लैडर पर स्नैप किए गए पिक्सेल में स्पष्ट चौड़ाई। |
height | पूर्णांक | पिक्सेल में स्पष्ट ऊंचाई। |
quality | पूर्णांक | एन्कोडर गुणवत्ता (40–100)। |
color | string | रंग का नाम (संवेदनशील; स्पेस को URL-encode करें, उदाहरण के लिए `Racing%20Red`). कार को मांग पर रंग किया जाता है — फिनिश-ट्रू, प्रतिबिंब और ट्रिम संरक्षित। एक कार के `/colors` में दिखाए गए सेट सूचीबद्ध है (हाउस कलर्स + इसके ब्रांड के कलर्स)। `/api/colors` से कोई भी सक्रिय रंग अनुरोध किया जा सकता है। अज्ञात रंग → डिफ़ॉल्ट पेंट + एररनोट `F04`. हर अन्य विकल्प के साथ मिलता है. **API v2 एड-ऑन:** साथ ही कोई भी 6-डिजिट हेक्स पेंट कलर, उदाहरण के लिए `c8102e`. |
shadow | string | स्टूडियो ग्राउंड शैडो — डिलीवरी के समय उत्पन्न होता है, हर बाहरी दृश्य के लिए उपलब्ध है. `mirroring=true` के साथ यह अंडरबॉडी शैडो को नियंत्रित करता है. truefalse |
transparency | string | पारदर्शी कट-आउट पृष्ठभूमि — हर बाहरी दृश्य के लिए उपलब्ध (PNG/WebP के साथ उपयोग करें)। truefalse |
ground | string | कार को ज़मीन पर बैठाएँ (एक पारदर्शी वैरिएंट की ज़रूरत है). true |
mirroring | string | परावर्ती फर्श। `true` = अंडरबॉडी शैडो के साथ, `clean` = केवल परावर्तन। एक पारदर्शी वैरिएंट की आवश्यकता है। trueclean |
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 |
