Strukturierte Ausgaben

response_format festlegen

Der JSON-Modus eignet sich für ein einfaches Objekt. JSON Schema ergänzt einen Schemanamen, eine Feldstruktur, Pflichtfelder und eine Möglichkeit, zusätzliche Felder abzulehnen.

Ein striktes Schema reduziert defensives Parsen, ersetzt aber niemals die Validierung auf Anwendungsseite.

{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Extract an order summary."}],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "order_summary",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {"items": {"type": "array"}, "total": {"type": "number"}},
        "required": ["items", "total"],
        "additionalProperties": false
      }
    }
  }
}

Schema entwerfen

• Halten Sie Felder und Beschreibungen knapp und domänenspezifisch.
• Setzen Sie additionalProperties: false, wenn unbekannte Felder nicht zulässig sind.
• Versionieren Sie Schemas in Ihrem eigenen Code, statt einen Vertrag, auf den sich nutzende Systeme verlassen, unbemerkt zu ändern.

Ergebnis verarbeiten

Validieren Sie zurückgegebenes JSON mit demselben Validator, den Ihre API oder Datenbank verwendet.

Wenn ein Modell oder eine Route das angeforderte Format nicht akzeptiert, zeigen Sie einen kontrollierten Fehler an und wählen Sie über den Modellkatalog eine kompatible Option.