3 में से पाठ 2 · 8 मिनट

संरचित आउटपुट पाएँ

JSON Schema भेजें ताकि मॉडल आपके ढाँचे में JSON लौटाए, फिर इस्तेमाल से पहले उसकी जाँच करें।

अनुरोध के साथ JSON Schema भेजें और मॉडल खुले टेक्स्ट के बजाय उसी ढाँचे में JSON लौटाता है। इसे तब इस्तेमाल करें जब आपको डेटा वापस चाहिए, जैसे किसी ईमेल से निकाले गए फ़ील्ड। जब आप चाहते हैं कि मॉडल आपके ऐप से कुछ करवाए, तब टूल कॉलिंग इस्तेमाल करें।

typeआपको क्या मिलता है
json_schemaआपके schema के अनुसार JSON। डिफ़ॉल्ट रूप से यही इस्तेमाल करें।
json_objectकोई मान्य JSON ऑब्जेक्ट, बिना तय ढाँचे के।
textसादा टेक्स्ट (डिफ़ॉल्ट)।

फ़ॉर्मैट /v1/chat/completions पर response_format में, /v1/responses पर text.format में और /v1/messages पर output_config.format में जाता है (सिर्फ़ json_schema)।

{
  "model": "openai/gpt-6-astra",
  "messages": [
    { "role": "user", "content": "Return the city and weather for London." }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "weather",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "city": { "type": "string" },
          "weather": { "type": "string" }
        },
        "required": ["city", "weather"],
        "additionalProperties": false
      }
    }
  }
}

JSON संदेश की content में स्ट्रिंग के रूप में आता है। पार्स करने से पहले जाँचें कि कहीं इनकार, गायब content या stop के अलावा कोई finish_reason तो नहीं। फिर पार्स किए गए ऑब्जेक्ट की जाँच करें, जैसे Zod से। जाँच विफल हो, तो प्रॉम्प्ट में त्रुटि के साथ एक बार दोबारा कोशिश करें, फिर एक सुरक्षित विफलता लौटाएँ। हर दोबारा कोशिश का शुल्क लगता है, और मान्य JSON होना यह साबित नहीं करता कि मान सही हैं।

Phaseo कभी response_format नहीं हटाता। वह json_schema अनुरोध को सिर्फ़ उन प्रदाताओं पर रूट करता है जो संरचित आउटपुट का समर्थन करते हैं; अगर मॉडल का कोई भी प्रदाता नहीं करता, तो अनुरोध 400 validation_error के साथ विफल होता है। मॉडल पेज समर्थन को structured_outputs से दिखाते हैं, जो एक क्षमता फ़्लैग है, अनुरोध फ़ील्ड नहीं।

अपनी समझ जाँचें

आप json_schema के साथ response_format ऐसे मॉडल को भेजते हैं जिसके प्रदाता संरचित आउटपुट का समर्थन नहीं करते। क्या होता है?

इसे लागू करें

आपका इनवॉइस पार्सर json_schema इस्तेमाल करता है, और कभी-कभी जवाब आपकी Zod जाँच में विफल होता है क्योंकि total गायब होता है। कोड को क्या करना चाहिए?

जवाब दिखाएँ

पहले जाँचें कि finish_reason का मान stop है, क्योंकि कटा हुआ जवाब मान्य नहीं हो सकता। फिर प्रॉम्प्ट में जाँच की त्रुटि के साथ एक बार दोबारा कोशिश करें, और फिर विफल हो तो अनुमान लगाने के बजाय सुरक्षित विफलता लौटाएँ। हर मॉडल और schema वर्शन के हिसाब से विफलताओं को ट्रैक करें ताकि किसी के भी बदलने पर चीज़ें बिगड़ें तो आपको पता चले।

मुख्य बात

तय ढाँचे में चाहिए डेटा के लिए json_schema इस्तेमाल करें, और नतीजे पर भरोसा करने से पहले हमेशा अपने कोड में उसकी जाँच करें।

संबंधित लिंक

प्रगति इसी ब्राउज़र में सेव होती है।

आखिरी बार जाँचा गया 17 नवंबर 2026