BroadRouter
शुरू करें

JSON मोड (JSON mode)

अपडेट किया गया

JSON मोड, LLM API की एक सेटिंग है, OpenAI जैसे API में response_format {"type": "json_object"}, जो मॉडल के जवाब को वैलिड और पार्स होने लायक़ JSON बनाती है। JSON Schema वाले स्ट्रक्चर्ड आउटपुट के उलट, यह गारंटी नहीं देती कि ऑब्जेक्ट में कौन-सी keys, टाइप या वैल्यू होंगी।

अन्य नाम: JSON मोड, JSON आउटपुट मोड, json mode kya hai, json_object kya hai, JSON mode, json_object, JSON output mode, JSON response mode

JSON मोड एक सवाल का जवाब देता है: क्या json.loads() चलेगा? दूसरे सवाल का जवाब नहीं देता: क्या यह वही ऑब्जेक्ट है जिसकी मेरे कोड को उम्मीद है?

यह कैसे काम करता है

Chat Completions API में इसे एक फ़ील्ड से चालू किया जाता है:

{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}

OpenAI का API रेफ़रंस इसे “the older JSON mode, which ensures the message the model generates is valid JSON” (अनुवाद: पुराना JSON मोड, जो पक्का करता है कि मॉडल का बनाया मैसेज वैलिड JSON हो) कहता है। इसके साथ दो नियम आते हैं। पहला, किसी मैसेज में JSON माँगना ज़रूरी है: OpenAI की गाइड कहती है कि API “will throw an error if the string ‘JSON’ does not appear somewhere in the context.” (अनुवाद: अगर कॉन्टेक्स्ट में कहीं ‘JSON’ स्ट्रिंग नहीं है तो एरर देगा।) दूसरा, आकार मॉडल पर छोड़ा जाता है। गाइड साफ़ कहती है कि JSON मोड “will not guarantee the output matches any specific schema.” (अनुवाद: गारंटी नहीं देगा कि आउटपुट किसी तय स्कीमा से मेल खाए।)

स्ट्रक्चर्ड आउटपुट ज़्यादा सख़्त विकल्प है। यह {"type": "json_schema", ...} के साथ एक JSON Schema भेजता है, और मॉडल उसी के दायरे में बंधा रहता है।

JSON मोड (json_object) स्ट्रक्चर्ड आउटपुट (json_schema)
वैलिड JSON हाँ हाँ
ज़रूरी keys और टाइप नहीं हाँ
स्कीमा आप देते हैं नहीं हाँ
प्रॉम्प्ट में “JSON” लिखना ज़रूरी हाँ (OpenAI) नहीं

OpenAI की सलाह है: “always using Structured Outputs instead of JSON mode when possible.” (अनुवाद: जहाँ हो सके, JSON मोड की जगह हमेशा Structured Outputs इस्तेमाल करें।)

यह क्यों मायने रखता है

  • वैलिडेशन अब भी आपकी ज़िम्मेदारी है. JSON मोड में कोई key ग़ायब हो या नंबर स्ट्रिंग बनकर आए, तो पार्सिंग ठीक चलती है और गड़बड़ बाद में निकलती है। कोड में स्कीमा से वैलिडेट करें।
  • कटा हुआ जवाब. अगर जवाब max_tokens पर पहुँच जाए, तो JSON अधूरा रहता है। रीज़निंग मॉडल पर यह ख़तरा ज़्यादा है, क्योंकि सोचने में भी वही बजट ख़र्च होता है।
  • फ़ॉलबैक. OpenAI की गाइड उन पुराने मॉडल के लिए JSON मोड बताती है जहाँ json_schema उपलब्ध नहीं है। सपोर्ट प्रोवाइडर और मॉडल के हिसाब से बदलता है, इसलिए जब स्कीमा स्वीकार न हो तो JSON मोड के साथ अपना वैलिडेशन ही फ़ॉलबैक है।

BroadNet Inference पर

BroadNet का API रेफ़रंस GLM 5.3 और Qwen3.8 27B के लिए स्ट्रक्चर्ड आउटपुट दिखाता है। यह नहीं बताता कि सपोर्टेड response_format, json_object है या json_schema, और न यह कि DeepSeek V4.1 Flash और BroadNet Gemma 4 VL 26B इनमें से कोई भी स्वीकार करते हैं या नहीं। अपने मॉडल पर दोनों टेस्ट करें। स्कीमा लिखने के लिए JSON Schema जनरेटर इस्तेमाल करें। JSON मोड बनाम json_schema वाली पोस्ट रिपेयर और मॉनिटरिंग समझाती है, और इनवॉइस गाइड इमेज से JSON निकालना दिखाती है।

अक्सर पूछे जाने वाले सवाल

क्या JSON मोड और स्ट्रक्चर्ड आउटपुट एक ही चीज़ हैं?

नहीं। OpenAI की गाइड कहती है कि दोनों वैलिड JSON देते हैं, लेकिन स्कीमा का पालन सिर्फ़ Structured Outputs पक्का करते हैं। JSON मोड कोई भी वैलिड ऑब्जेक्ट लौटा सकता है।

JSON मोड, JSON शब्द को लेकर एरर क्यों देता है?

OpenAI चाहता है कि मैसेज में कहीं JSON बनाने का निर्देश हो। अगर कॉन्टेक्स्ट में "JSON" स्ट्रिंग नहीं है, तो API एरर देता है।

क्या JSON मोड फिर भी टूटा हुआ JSON लौटा सकता है?

हाँ, अगर जवाब max_tokens या कॉन्टेक्स्ट सीमा पर कट जाए। पार्स करने से पहले finish_reason देखें।

Markdown में पढ़ेंChatGPT से पूछेंClaude से पूछेंPerplexity से पूछें