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 نکالنا دکھاتی ہے۔