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 निकालना दिखाती है।