संरचित आउटपुट एक भाषा मॉडल को JSON लौटाता है जिसे आपका कोड मुक्त पाठ के बजाय पार्स कर सकता है। JSON मोड एक व्याकरणिक रूप से मान्य JSON ऑब्जेक्ट लौटाता है, और JSON स्कीमा आगे बढ़कर प्रतिक्रिया को आपके परिभाषित स्कीमा से मेल खाता है, जिसमें आवश्यक फ़ील्ड और प्रकार होते हैं।
एप्लिकेशन को अक्सर मॉडल के उत्तर के रूप में डेटा की आवश्यकता होती है: चालान से निकाले गए फ़ील्ड्स, सपोर्ट टिकट के लिए लेबल, योजना के चरण, सेव करने के लिए रिकॉर्ड। प्रॉम्प्ट में JSON मांगना अधिकांश समय काम करता है, लेकिन मुफ्त टेक्स्ट JSON से पहले एक व्याख्या, उसके चारों ओर कोड फेंस, एक गायब फील्ड या स्ट्रिंग के रूप में लिखी गई संख्या के साथ आ सकता है। इनमें से प्रत्येक पार्सर को तोड़ता है।
संरचित आउटपुट स्वयं जनरेशन को सीमित करता है। प्रतिक्रिया मान्य JSON है, और स्कीमा के साथ इसका आकार भी ठीक वही होता है जो आपने मांगा था।
दो स्तर हैं, दोनों सेट response_format:
{"प्रकार": "json_object"} मॉडल को एक वैध 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 बिना तर्क के जवाब देता है जब तक कि यह भी सेट न हो सक्षम।.ब्राउज़ करें टेक्स्ट मॉडल तुलना करने के लिए कि कौन सा स्तर प्रत्येक स्तर का समर्थन करता है।
62 मॉडल। हर मॉडल के पेज पर उसका रेट कार्ड, पैरामीटर और कोड है।
| मॉडल | संरचित आउटपुट | कॉन्टेक्स्ट विंडो |
|---|---|---|
| DeepSeek V4 Pro DeepSeek | JSON Schema | 1M टोकन |
| DeepSeek V4 Pro 0813 DeepSeek | JSON Schema | 1M टोकन |
| Fugu Max Sakana AI | JSON Schema | 1M टोकन |
| Fugu Ultra v1.1 Sakana AI | JSON Schema | 1M टोकन |
| Fugu Ultra v2.0 Sakana AI | JSON Schema | 1M टोकन |
| Gemma 4 26B-A4B Google | JSON Schema | 256K टोकन |
| Kimi K2.6 Moonshot AI | JSON Schema | 256K टोकन |
| Kimi K2.7 Code Moonshot AI | JSON Schema | 256K टोकन |
| मॉडल | संरचित आउटपुट | कॉन्टेक्स्ट विंडो |
|---|---|---|
| Kimi K2.7 Code Highspeed Moonshot AI | JSON Schema | 256K टोकन |
| Kimi K3 Moonshot AI | JSON Schema | 1M टोकन |
| Kimi K3.1 Pro Moonshot AI | JSON Schema | 1M टोकन |
| MiMo V2.6 Flash Xiaomi | JSON Schema | 1M टोकन |
| MiMo V2.6 Pro Xiaomi | JSON Schema | 1M टोकन |
| MiMo V2.6 Pro UltraSpeed Xiaomi | JSON Schema | 1M टोकन |
| Mistral Small 3.1 Mistral AI | JSON Schema | 89.6K टोकन |
| Muse Glimmer 30B Meta AI | JSON Schema | 128K टोकन |
| Muse Spark 1.1 Meta AI | JSON Schema | 1M टोकन |
| Muse Spark 1.2 Meta AI | JSON Schema | 1M टोकन |
| Muse Spark 1.3 Meta AI | JSON Schema | 1M टोकन |
| Qwen3.5 4B Alibaba Cloud | JSON Schema | 256K टोकन |
| Qwen3.5 9B Alibaba Cloud | JSON Schema | 256K टोकन |
| Qwen3.5 Omni Plus Alibaba Cloud | JSON Schema | 192K टोकन |
| Qwen3.6 35B A3B Alibaba Cloud | JSON Schema | 128K टोकन |
| Qwen3.7 Flash Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.7 Max Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.7 Plus Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.8 27B Alibaba Cloud | JSON Schema | 256K टोकन |
| Qwen3.8 Flash Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.8 Max Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.8 Max 0902 Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Qwen3.8 Omni Flash Alibaba Cloud | JSON Schema | 1.01M टोकन |
| Qwen4 Max Alibaba Cloud | JSON Schema | 983.6K टोकन |
| Seed 2.0 Lite ByteDance | JSON Schema | 229.1K टोकन |
| Seed 2.0 Mini ByteDance | JSON Schema | 229.2K टोकन |
| Seed 2.0 Pro ByteDance | JSON Schema | 229.1K टोकन |
| Seed 2.1 Turbo ByteDance | JSON Schema | 229.1K टोकन |
| Step 5 Preview StepFun | JSON Schema | 1.02M टोकन |
| DeepSeek V4 Flash 0731 DeepSeek | JSON मोड | 1M टोकन |
| DeepSeek V4.1 Flash 1017 DeepSeek | JSON मोड | 1M टोकन |
| Fugu Ultra v1.0 Sakana AI | JSON मोड | 1M टोकन |
| GLM 4.5 Flash Z.ai | JSON मोड | 128K टोकन |
| GLM 4.6V Flash Z.ai | JSON मोड | 128K टोकन |
| GLM 4.6V FlashX Z.ai | JSON मोड | 128K टोकन |
| GLM 4.7 Flash Z.ai | JSON मोड | 202.8K टोकन |
| GLM 4.7 FlashX Z.ai | JSON मोड | 202.8K टोकन |
| GLM 5.1 Z.ai | JSON मोड | 202.7K टोकन |
| GLM 5.2 Z.ai | JSON मोड | 1M टोकन |
| GLM 5.3 Z.ai | JSON मोड | 1M टोकन |
| GLM 5.3 Flash Z.ai | JSON मोड | 1M टोकन |
| Mistral Small 4 Mistral AI | JSON मोड | 256K टोकन |
| Qwen3.5 122B-A10B Alibaba Cloud | JSON मोड | 258K टोकन |
| Qwen3.5 27B Alibaba Cloud | JSON मोड | 258K टोकन |
| Qwen3.5 35B-A3B Alibaba Cloud | JSON मोड | 258K टोकन |
| Qwen3.5 397B-A17B Alibaba Cloud | JSON मोड | 258K टोकन |
| Qwen3.5 Flash Alibaba Cloud | JSON मोड | 995.9K टोकन |
| Qwen3.5 Plus Alibaba Cloud | JSON मोड | 983.6K टोकन |
| Qwen3.6 27B Alibaba Cloud | JSON मोड | 224K टोकन |
| Qwen3.6 Flash Alibaba Cloud | JSON मोड | 983.6K टोकन |
| Qwen3.6 Plus Alibaba Cloud | JSON मोड | 983.6K टोकन |
| Step 3.7 Flash StepFun | JSON मोड | 256K टोकन |
| StepAudio 2.5 Chat StepFun | JSON मोड | 256K टोकन |
| StepAudio 3 Chat StepFun | JSON मोड | 256K टोकन |
JSON मोड एक वैध JSON ऑब्जेक्ट लौटाता है लेकिन उसका आकार आपके प्रॉम्प्ट पर छोड़ देता है। JSON स्कीमा प्रतिक्रिया को आपके द्वारा प्रदान किए गए स्कीमा से मेल खाता है, जिसमें आवश्यक फ़ील्ड और प्रकार शामिल हैं।
सपोर्ट प्रति मॉडल है। प्रत्येक मॉडल का structured_output फील्ड केवल स्कीमा सपोर्ट के लिए json_schema या JSON मोड के लिए json_object पढ़ता है, और असमर्थित फॉर्मेट के लिए अनुरोध 400 त्रुटि लौटाता है।
हाँ। आउटपुट सीमा से प्रतिक्रिया कट हो सकती है, और आपके एप्लिकेशन में ऐसे नियम हो सकते हैं जिन्हें स्कीमा व्यक्त नहीं कर सकता, इसलिए हर प्रतिक्रिया को पार्स और मान्य करें।
हाँ। Responses एंडपॉइंट text.format का उपयोग करता है, और Messages एंडपॉइंट output_config.format या response_format फ़ील्ड स्वीकार करता है।
हमारे मूल्य निर्धारण की जाँच करें या यदि आप चाहते हैं कि आपका अपना मॉडल हमारे स्टैक पर तैनात किया जाए, तो पहुंचें।