चित्र
एक साइन किया गया इमेज 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-एन्कोड करें, उदाहरण के लिए `Racing%20Red`). कार की पेंटिंग ऑन-डिमांड पर की जाती है — फिनिश-ट्रू, रिफ्लेक्शंस और ट्रिम संरक्षित। एक कार की `/colors` उसकी दिखाई गई सेट को सूचीबद्ध करती है (हाउस कलर्स + उसके ब्रांड के कलर्स); `/api/colors` से कोई भी एक्टिव कलर रिक्वेस्ट किया जा सकता है। अनजान रंग → डिफ़ॉल्ट पेंट + एररनोट `F04`. यह हर दूसरे ऑप्शन के साथ मिलता है. **API v2 एड-ऑन:** कैटलॉग कलर्स उनके वास्तविक फिनिश के साथ आते हैं (मेटैलिक, पर्ल, मैट, सैटन, क्रोम, एल्यूमिनियम, कार्बन). साथ ही कोई भी 6-डिजिट हेक्स पेंट कलर, उदाहरण के लिए `c8102e` (ग्लॉस), या एक हेक्स कलर के साथ एक फिनिश: `<finish>_<hex>`, उदाहरण के लिए `metallic_315fbf`, `matte_283b56`, `carbon_545454`, `chrome_eac972`; मेटैलिक, पर्ल और सैटन एक ऑप्शनल सेकंड कलर लेते हैं प्रभाव के लिए, उदाहरण के लिए `metallic_315fbf_5693f9`. फिनिश: `solid`, `metallic`, `pearl`, `satin`, `matte` (साथ ही `matt`), `chrome`, `aluminium`, `carbon`. |
shadow | string | स्टूडियो ग्राउंड शैडो — डिलीवरी के समय उत्पन्न होता है, हर बाहरी दृश्य के लिए उपलब्ध है. `mirroring=true` के साथ यह अंडरबॉडी शैडो को नियंत्रित करता है. truefalse |
transparency | string | पारदर्शी कट-आउट पृष्ठभूमि — हर बाहरी दृश्य के लिए उपलब्ध (PNG/WebP के साथ उपयोग करें)। truefalse |
ground | string | कार को ज़मीन पर बैठाएँ (एक पारदर्शी वैरिएंट की ज़रूरत है). true |
mirroring | string | परावर्ती फर्श। `true` = अंडरबॉडी शैडो के साथ, `clean` = केवल परावर्तन। एक पारदर्शी वैरिएंट की आवश्यकता है। trueclean |
lights | string | **API v2 एड-ऑन:** हेडलाइट्स ऑन या ऑफ। **डिफ़ॉल्ट `ऑन`:** पैरामीटर के बिना छवि हेडलाइट्स के साथ आती है, जहाँ भी छवि में हैं; `lights=off` भेजें बिना हेडलाइट्स वाली छवि के लिए। कोई लाइट वैरिएंट न होने वाली छवि बिना लाइट्स के आती है; `lights=on` के साथ यह `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:** licence plate — `none` = जैसा कि छवि में है (डिफ़ॉल्ट), `blank` = खाली प्लेट, `logo` = आपका लोगो प्लेट पर (आपके की पर सेटअप; गायब → खाली + त्रुटि नोट `N30`), `text` = आपका खुद का टेक्स्ट `plate_text` से (आपके की के लिए सक्षम होना चाहिए, देखें `addon.plate_text` in `/api/me`; अन्यथा त्रुटि नोट `O31`). noneblanklogotext |
plate_text | string | **API v2 add-on:** `plate=text` के लिए टेक्स्ट — 10 अक्षरों तक: अक्षर, अंक, स्पेस और `-` `.` `&`. प्लेट पर भेजे गए अनुसार लिखा जाता है (ऊपरी और निचले केस दोनों रखे जाते हैं), केंद्रित और प्लेट की अनुमति के अनुसार बड़ा। गायब, बहुत लंबा या अन्य अक्षर → `400`. |
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 |
version | string | केवल एक संस्करण के परिणाम: `v1` = स्टैंडर्ड छवियाँ, `v2` = API v2 अतिरिक्त (स्टैंडर्ड छवियों पर कोई वापसी नहीं). इसके बिना: आपका की आपकी अनुमति देता है। आपकी की के लिए अनुमति नहीं → `403`. v1v2 |
