ما هو الناتج المنظم؟

الناتج المنظم يجعل نموذج اللغة يرجع JSON يمكن للكود تحليله بدلا من النص الحر. يعيد وضع JSON كائن JSON صالح نحويا، ويذهب مخطط JSON أبعد من ذلك بجعل الاستجابة تطابق المخطط الذي تحدده، مع حقوله وأنواعها المطلوبة.

المفاهيم

لماذا يهم الناتج المنظم

غالبا ما تحتاج التطبيقات إلى إجابة النموذج كبيانات: حقول مستخرجة من فاتورة، تسمية لتذكرة دعم، خطوات الخطة، سجل للحفظ. طلب JSON في المطالبة يعمل في معظم الأحيان، لكن النص الحر يمكن أن يصل مع شرح قبل JSON، أو سياج كود حوله، أو حقل مفقود، أو رقم مكتوب كنص. كل واحدة من هذه النقاط تكسر محلل المعلومات.

المخرجات المنظمة تقيد التوليد نفسه. الرد هو JSON صالح، ومع المخطط له الشكل الدقيق الذي طلبته.

وضع JSON ومخطط JSON

هناك مستويان، كلاهما محدد مع response_format:

  • وضع JSON. {"type": "json_object"} يجعل النموذج يعيد كائن JSON صالح. تصف الحقول التي تريدها في المطالبة، ولا يتم فرض الشكل.
  • مخطط JSON. {"type": "json_schema", "json_schema": {...}} يأخذ الاسم, a مخطط و صارم، ويجعل الناتج يتوافق مع مخطط JSON هذا: الحقول المطلوبة موجودة، الأنواع صحيحة، ولا توجد مفاتيح إضافية عند تعيين additionalproperties إلى خطأ.

استخدم مخطط JSON عندما يدعمه النموذج ويعتمد كودك على الحقول الدقيقة. حدد كل حقل يقرأه الكود حسب الحاجة، استخدم حرب للخيارات الثابتة، حافظ على التعشيش بشكل سطحي، وأضف قصيرا الوصف لأي مجال لا يكون معناه واضحا من اسمه.

بالنسبة لمستخرج الفاتورة، قد يتطلب مخطط مورد كخيط، إجمالي كرقم، عملة ك حرب من الرموز التي تقبلها، و line_items كمصفوفة من الكائنات مع الوصف و المبلغ. مع صارم تم ضبطه على صحيح، كل استجابة تحمل تلك الحقول بتلك الأنواع، لذا يقرأ الكود نفس المفاتيح في كل مرة. مع وضع JSON، ضع كائن مثال قصير في المطالبة بدلا من ذلك، حتى يكون للنموذج شكل يتبعه.

الدعم حسب النموذج ونقطة النهاية

يتم تعيين الدعم حسب الطراز. structured_output حقل على ابدأ /v1/models/{model} يقرأ json_schema عندما يدعم النموذج المخططات و json_object عندما يدعم وضع JSON فقط، وتظهر النماذج في هذه الصفحة المستوى الذي يمتلكه كل منها. إرسال تنسيق لا يدعم النموذج إرجاع 400.

تعمل نفس الميزة على كل نقطة نهاية نصية، في شكل خاص بتلك النقطة:

  • /v1/chat/completions و /v1/completions: response_format.
  • /v1/responses: text.format.
  • /v1/messages: output_config.format، أو a response_format بجانب بقية الطلب.

في Playground، نماذج الدردشة التي تدعمها تحتوي على وضع إيقاف، وضع JSON، وتحكم مخطط JSON، مع صندوق لمخططك. ال دليل التوافق يحتوي على أمثلة كاملة للطلبات.

الإرشاد العملي

  • تأكد على أي حال. تحليل وفحص كل استجابة في الكود. استجابة مقطوعة بحد الإخراج، يتم الإبلاغ عنها ك finish_reason الطول، هو JSON غير مكتمل، لذا تم تعيين max_tokens مرتفع بما يكفي لأكبر جسم تتوقعه.
  • تحقق من نماذج التفكير. في بعض النماذج، طلب مع response_format إجابات بدون مبرر إلا إذا كان أيضا يحدد enable_thinking.
  • نماذج بدون دعم. اطلب 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 DeepSeekوضع JSON1M رمز
DeepSeek V4.1 Flash 1017 DeepSeekوضع JSON1M رمز
Fugu Ultra v1.0 Sakana AIوضع JSON1M رمز
GLM 4.5 Flash Z.aiوضع JSON128K رمز
GLM 4.6V Flash Z.aiوضع JSON128K رمز
GLM 4.6V FlashX Z.aiوضع JSON128K رمز
GLM 4.7 Flash Z.aiوضع JSON202.8K رمز
GLM 4.7 FlashX Z.aiوضع JSON202.8K رمز
GLM 5.1 Z.aiوضع JSON202.7K رمز
GLM 5.2 Z.aiوضع JSON1M رمز
GLM 5.3 Z.aiوضع JSON1M رمز
GLM 5.3 Flash Z.aiوضع JSON1M رمز
Mistral Small 4 Mistral AIوضع JSON256K رمز
Qwen3.5 122B-A10B Alibaba Cloudوضع JSON258K رمز
Qwen3.5 27B Alibaba Cloudوضع JSON258K رمز
Qwen3.5 35B-A3B Alibaba Cloudوضع JSON258K رمز
Qwen3.5 397B-A17B Alibaba Cloudوضع JSON258K رمز
Qwen3.5 Flash Alibaba Cloudوضع JSON995.9K رمز
Qwen3.5 Plus Alibaba Cloudوضع JSON983.6K رمز
Qwen3.6 27B Alibaba Cloudوضع JSON224K رمز
Qwen3.6 Flash Alibaba Cloudوضع JSON983.6K رمز
Qwen3.6 Plus Alibaba Cloudوضع JSON983.6K رمز
Step 3.7 Flash StepFunوضع JSON256K رمز
StepAudio 2.5 Chat StepFunوضع JSON256K رمز
StepAudio 3 Chat StepFunوضع JSON256K رمز

الأسئلة الشائعة

ما الفرق بين وضع JSON ومخطط JSON؟

يعيد وضع JSON كائن JSON صالح لكنه يترك شكله لمطالبتك. يجعل مخطط JSON الاستجابة تطابق المخطط الذي تقدمه، بما في ذلك الحقول والأنواع المطلوبة.

أي النماذج تدعم المخرجات المنظمة؟

الدعم مخصص لكل نموذج. يقرأ حقل structured_output لكل نموذج json_schema لدعم المخطط أو json_object لوضع JSON فقط، وطلب تنسيق غير مدعوم يعيد خطأ 400.

هل ما زلت بحاجة إلى التحقق من JSON؟

نعم. يمكن قطع الرد بحد الإخراج، وقد يحتوي تطبيقك على قواعد لا يستطيع المخطط التعبير عنها، لذا قم بتحليل والتحقق من صحة كل رد.

هل يمكنني استخدام المخرجات المنظمة مع نقاط نهاية الردود أو الرسائل؟

نعم. تستخدم نقطة نهاية الردود text.format، وتقبل نقطة نهاية الرسائل output_config.format أو حقل response_format.

هل أنت مستعد لاستخدام نقاط نهاية أفضل؟

تحقق من تسعيرنا أو تواصل إذا كنت ترغب في نشر نموذجك الخاص على مجموعتنا.