संरचित आउटपुट क्या है?

संरचित आउटपुट एक भाषा मॉडल को JSON लौटाता है जिसे आपका कोड मुक्त पाठ के बजाय पार्स कर सकता है। JSON मोड एक व्याकरणिक रूप से मान्य JSON ऑब्जेक्ट लौटाता है, और JSON स्कीमा आगे बढ़कर प्रतिक्रिया को आपके परिभाषित स्कीमा से मेल खाता है, जिसमें आवश्यक फ़ील्ड और प्रकार होते हैं।

अवधारणाएँ

संरचित आउटपुट क्यों महत्वपूर्ण है

एप्लिकेशन को अक्सर मॉडल के उत्तर के रूप में डेटा की आवश्यकता होती है: चालान से निकाले गए फ़ील्ड्स, सपोर्ट टिकट के लिए लेबल, योजना के चरण, सेव करने के लिए रिकॉर्ड। प्रॉम्प्ट में JSON मांगना अधिकांश समय काम करता है, लेकिन मुफ्त टेक्स्ट JSON से पहले एक व्याख्या, उसके चारों ओर कोड फेंस, एक गायब फील्ड या स्ट्रिंग के रूप में लिखी गई संख्या के साथ आ सकता है। इनमें से प्रत्येक पार्सर को तोड़ता है।

संरचित आउटपुट स्वयं जनरेशन को सीमित करता है। प्रतिक्रिया मान्य JSON है, और स्कीमा के साथ इसका आकार भी ठीक वही होता है जो आपने मांगा था।

JSON मोड और JSON स्कीमा

दो स्तर हैं, दोनों सेट response_format:

  • JSON मोड। {"प्रकार": "json_object"} मॉडल को एक वैध JSON ऑब्जेक्ट लौटाता है। आप प्रॉम्प्ट में उन फ़ील्ड्स का वर्णन करते हैं जिन्हें आप चाहते हैं, और आकार लागू नहीं होता।
  • JSON स्कीमा। {"type": "json_schema", "json_schema": {...}} लेता है नाम, a स्कीमा तथा यथातथ्‍य, और आउटपुट को उस JSON स्कीमा के अनुरूप बनाता है: आवश्यक फ़ील्ड मौजूद हैं, प्रकार सही हैं, और जब आप सेट करते हैं तो कोई अतिरिक्त कुंजी नहीं अतिरिक्त गुण सेवा मेरे गलत।.

जब मॉडल JSON स्कीमा का समर्थन करता हो और आपका कोड सटीक फ़ील्ड्स पर निर्भर करता हो, तो JSON स्कीमा का उपयोग करें। हर उस फ़ील्ड को चिह्नित करें जिसे आपका कोड पढ़ता है, आवश्यकतानुसार उपयोग करें। एनम निश्चित विकल्पों के लिए, घोंसला कम उथला रखें, और एक शॉर्ट जोड़ें या क़िस्‍म किसी भी क्षेत्र के लिए जिसका अर्थ उसके नाम से स्पष्ट नहीं है।

इनवॉइस एक्स्ट्रैक्टर के लिए, स्कीमा की आवश्यकता हो सकती है विक्रेता एक डोरी के रूप में, कुल एक संख्या के रूप में, मुद्रा एक के रूप में एनम उन कोड्स में से जिन्हें आप स्वीकार करते हैं, और line_items ऑब्जेक्ट्स की एक एरे के रूप में या क़िस्‍म तथा कुल धनराशि. के साथ यथातथ्‍य पर सेट करें सच, प्रत्येक प्रतिक्रिया उन फ़ील्ड्स को उन प्रकारों के साथ ले जाती है, इसलिए आपका कोड हर बार वही कुंजियाँ पढ़ता है। JSON मोड में, प्रॉम्प्ट में एक छोटा उदाहरण ऑब्जेक्ट डालें, ताकि मॉडल के लिए एक आकार हो।

मॉडल और एंडपॉइंट द्वारा समर्थन

सपोर्ट प्रत्येक मॉडल के लिए सेट किया जाता है। structured_output मैदान पर /v1/models/{model} पढ़ता है json_schema जब मॉडल स्कीमा का समर्थन करता है और json_object जब यह केवल JSON मोड का समर्थन करता है, और इस पृष्ठ पर मॉडल दिखाते हैं कि प्रत्येक का स्तर कौन सा है। मॉडल द्वारा समर्थित प्रारूप भेजने पर फर्क पड़ता है 400।.

वही फीचर प्रत्येक टेक्स्ट एंडपॉइंट पर काम करता है, उस एंडपॉइंट के अपने आकार में:

  • /v1/chat/completions तथा /v1/completions: response_format।.
  • TOKEN: text.format।.
  • TOKEN: output_config.फॉर्मेट, या एक response_format बाकी अनुरोध के बगल में।

में Playground, जो चैट मॉडल इसे सपोर्ट करते हैं, उनमें Off, JSON मोड और JSON स्कीमा कंट्रोल होता है, साथ ही आपके स्कीमा के लिए एक बॉक्स होता है। द संगतता मार्गदर्शिका पूर्ण अनुरोध उदाहरण हैं।

व्यावहारिक मार्गदर्शन

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

ब्राउज़ करें टेक्स्ट मॉडल तुलना करने के लिए कि कौन सा स्तर प्रत्येक स्तर का समर्थन करता है।

मॉडल के अनुसार स्ट्रक्चर्ड आउटपुट सपोर्ट

62 मॉडल। हर मॉडल के पेज पर उसका रेट कार्ड, पैरामीटर और कोड है।

मॉडलसंरचित आउटपुटकॉन्टेक्स्ट विंडो
DeepSeek V4 Pro DeepSeekJSON Schema1M टोकन
DeepSeek V4 Pro 0813 DeepSeekJSON Schema1M टोकन
Fugu Max Sakana AIJSON Schema1M टोकन
Fugu Ultra v1.1 Sakana AIJSON Schema1M टोकन
Fugu Ultra v2.0 Sakana AIJSON Schema1M टोकन
Gemma 4 26B-A4B GoogleJSON Schema256K टोकन
Kimi K2.6 Moonshot AIJSON Schema256K टोकन
Kimi K2.7 Code Moonshot AIJSON Schema256K टोकन
सभी 62 मॉडल दिखाएँ
मॉडलसंरचित आउटपुटकॉन्टेक्स्ट विंडो
Kimi K2.7 Code Highspeed Moonshot AIJSON Schema256K टोकन
Kimi K3 Moonshot AIJSON Schema1M टोकन
Kimi K3.1 Pro Moonshot AIJSON Schema1M टोकन
MiMo V2.6 Flash XiaomiJSON Schema1M टोकन
MiMo V2.6 Pro XiaomiJSON Schema1M टोकन
MiMo V2.6 Pro UltraSpeed XiaomiJSON Schema1M टोकन
Mistral Small 3.1 Mistral AIJSON Schema89.6K टोकन
Muse Glimmer 30B Meta AIJSON Schema128K टोकन
Muse Spark 1.1 Meta AIJSON Schema1M टोकन
Muse Spark 1.2 Meta AIJSON Schema1M टोकन
Muse Spark 1.3 Meta AIJSON Schema1M टोकन
Qwen3.5 4B Alibaba CloudJSON Schema256K टोकन
Qwen3.5 9B Alibaba CloudJSON Schema256K टोकन
Qwen3.5 Omni Plus Alibaba CloudJSON Schema192K टोकन
Qwen3.6 35B A3B Alibaba CloudJSON Schema128K टोकन
Qwen3.7 Flash Alibaba CloudJSON Schema983.6K टोकन
Qwen3.7 Max Alibaba CloudJSON Schema983.6K टोकन
Qwen3.7 Plus Alibaba CloudJSON Schema983.6K टोकन
Qwen3.8 27B Alibaba CloudJSON Schema256K टोकन
Qwen3.8 Flash Alibaba CloudJSON Schema983.6K टोकन
Qwen3.8 Max Alibaba CloudJSON Schema983.6K टोकन
Qwen3.8 Max 0902 Alibaba CloudJSON Schema983.6K टोकन
Qwen3.8 Omni Flash Alibaba CloudJSON Schema1.01M टोकन
Qwen4 Max Alibaba CloudJSON Schema983.6K टोकन
Seed 2.0 Lite ByteDanceJSON Schema229.1K टोकन
Seed 2.0 Mini ByteDanceJSON Schema229.2K टोकन
Seed 2.0 Pro ByteDanceJSON Schema229.1K टोकन
Seed 2.1 Turbo ByteDanceJSON Schema229.1K टोकन
Step 5 Preview StepFunJSON Schema1.02M टोकन
DeepSeek V4 Flash 0731 DeepSeekJSON मोड1M टोकन
DeepSeek V4.1 Flash 1017 DeepSeekJSON मोड1M टोकन
Fugu Ultra v1.0 Sakana AIJSON मोड1M टोकन
GLM 4.5 Flash Z.aiJSON मोड128K टोकन
GLM 4.6V Flash Z.aiJSON मोड128K टोकन
GLM 4.6V FlashX Z.aiJSON मोड128K टोकन
GLM 4.7 Flash Z.aiJSON मोड202.8K टोकन
GLM 4.7 FlashX Z.aiJSON मोड202.8K टोकन
GLM 5.1 Z.aiJSON मोड202.7K टोकन
GLM 5.2 Z.aiJSON मोड1M टोकन
GLM 5.3 Z.aiJSON मोड1M टोकन
GLM 5.3 Flash Z.aiJSON मोड1M टोकन
Mistral Small 4 Mistral AIJSON मोड256K टोकन
Qwen3.5 122B-A10B Alibaba CloudJSON मोड258K टोकन
Qwen3.5 27B Alibaba CloudJSON मोड258K टोकन
Qwen3.5 35B-A3B Alibaba CloudJSON मोड258K टोकन
Qwen3.5 397B-A17B Alibaba CloudJSON मोड258K टोकन
Qwen3.5 Flash Alibaba CloudJSON मोड995.9K टोकन
Qwen3.5 Plus Alibaba CloudJSON मोड983.6K टोकन
Qwen3.6 27B Alibaba CloudJSON मोड224K टोकन
Qwen3.6 Flash Alibaba CloudJSON मोड983.6K टोकन
Qwen3.6 Plus Alibaba CloudJSON मोड983.6K टोकन
Step 3.7 Flash StepFunJSON मोड256K टोकन
StepAudio 2.5 Chat StepFunJSON मोड256K टोकन
StepAudio 3 Chat StepFunJSON मोड256K टोकन

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

JSON मोड और JSON स्कीमा में क्या अंतर है?

JSON मोड एक वैध JSON ऑब्जेक्ट लौटाता है लेकिन उसका आकार आपके प्रॉम्प्ट पर छोड़ देता है। JSON स्कीमा प्रतिक्रिया को आपके द्वारा प्रदान किए गए स्कीमा से मेल खाता है, जिसमें आवश्यक फ़ील्ड और प्रकार शामिल हैं।

कौन से मॉडल संरचित आउटपुट का समर्थन करते हैं?

सपोर्ट प्रति मॉडल है। प्रत्येक मॉडल का structured_output फील्ड केवल स्कीमा सपोर्ट के लिए json_schema या JSON मोड के लिए json_object पढ़ता है, और असमर्थित फॉर्मेट के लिए अनुरोध 400 त्रुटि लौटाता है।

क्या मुझे अभी भी JSON को वैलिडेट करना होगा?

हाँ। आउटपुट सीमा से प्रतिक्रिया कट हो सकती है, और आपके एप्लिकेशन में ऐसे नियम हो सकते हैं जिन्हें स्कीमा व्यक्त नहीं कर सकता, इसलिए हर प्रतिक्रिया को पार्स और मान्य करें।

क्या मैं Responses या Messages एंडपॉइंट्स के साथ संरचित आउटपुट का उपयोग कर सकता हूँ?

हाँ। Responses एंडपॉइंट text.format का उपयोग करता है, और Messages एंडपॉइंट output_config.format या response_format फ़ील्ड स्वीकार करता है।

बेहतर समापन बिंदुओं का उपयोग करने के लिए तैयार हैं?

हमारे मूल्य निर्धारण की जाँच करें या यदि आप चाहते हैं कि आपका अपना मॉडल हमारे स्टैक पर तैनात किया जाए, तो पहुंचें।