BroadRouter
شروع کریں

JSON موڈ (JSON mode)

اپ ڈیٹ

JSON موڈ، LLM API کی ایک سیٹنگ ہے، OpenAI طرز کے APIs میں 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 سے پوچھیں