الانتقال إلى المحتوى الرئيسي
مساران:
  • response_format: {"type": "json_object"} — يعيد النموذج JSON صالحاً
  • response_format: {"type": "json_schema", "json_schema": {...}} — تتوافق مخرجات النموذج مع مخططك

مثال (json_schema، OpenAI)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Extract name and age."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "person",
            "strict": True,
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "age": {"type": "integer"},
                },
                "required": ["name", "age"],
            },
        },
    },
)

الدعم عبر المزوّدين

response_format مدعوم حيثما يستطيع النموذج الأعلى احترامه. بالنسبة لـ Gemini، تربطه طبقة الترجمة في OrcaRouter بـ responseMimeType + responseSchema. وبالنسبة لـ OpenAI / Grok / DeepSeek (جميع المصادر الأعلى المتوافقة مع OpenAI)، يصل الحقل إلى المصدر الأعلى بشكله الأصلي. لا تكشف Anthropic عن مكافئ لـ response_format، لذا استخدم نمط tool_use الخاص بـ Anthropic عندما تحتاج إلى مخرجات مقيّدة بمخطط هناك.
المزوّدjson_objectjson_schemaملاحظات
OpenAIشكل الحقل الأصلي لـ OpenAI
Grok (xAI)xAI متوافق مع OpenAI
DeepSeek⚠️تحقّق من الدعم لكل نموذج لدى DeepSeek
Geminiيُترجم إلى responseMimeType + responseSchema
Anthropicاستخدم نمط tool_use بدلاً من ذلك

انظر أيضاً