Strukturierte Ausgaben erhalten
Sende ein JSON Schema, damit das Modell JSON in deiner Form zurückgibt, und validiere es, bevor du es nutzt.
Sende ein JSON Schema mit der Anfrage, dann gibt das Modell JSON in dieser Form statt freiem Text zurück. Nutze das, wenn du Daten zurückhaben willst, etwa Felder aus einer E-Mail. Nutze Tool-Aufrufe, wenn das Modell deine App bitten soll, etwas zu tun.
type | Was du bekommst |
|---|---|
json_schema | JSON, das deinem Schema folgt. Nutze das standardmäßig. |
json_object | Irgendein gültiges JSON-Objekt, ohne erzwungene Form. |
text | Reinen Text (der Standard). |
Das Format gehört in response_format bei /v1/chat/completions, in text.format bei /v1/responses und in output_config.format bei /v1/messages (nur json_schema).
{
"model": "openai/gpt-6-astra",
"messages": [
{ "role": "user", "content": "Return the city and weather for London." }
],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "weather",
"strict": true,
"schema": {
"type": "object",
"properties": {
"city": { "type": "string" },
"weather": { "type": "string" }
},
"required": ["city", "weather"],
"additionalProperties": false
}
}
}
}
Das JSON kommt als String im Nachrichteninhalt zurück. Bevor du es parst, prüfe auf eine Ablehnung, fehlenden Inhalt oder ein finish_reason außer stop. Validiere dann das geparste Objekt, zum Beispiel mit Zod. Schlägt die Validierung fehl, versuche es einmal mit dem Fehler im Prompt erneut und gib dann einen sicheren Fehler zurück. Jede Wiederholung kostet, und gültiges JSON beweist noch nicht, dass die Werte stimmen.
Phaseo verwirft response_format nie. Es routet eine json_schema-Anfrage nur an Anbieter, die strukturierte Ausgaben unterstützen; unterstützt keiner der Anbieter des Modells sie, schlägt die Anfrage mit 400 validation_error fehl. Modellseiten kennzeichnen die Unterstützung mit structured_outputs; das ist ein Funktionsmerkmal, kein Anfragefeld.
Prüfe dein Verständnis
Du sendest response_format mit json_schema an ein Modell, dessen Anbieter keine strukturierten Ausgaben unterstützen. Was passiert?
Wende es an
Dein Rechnungsparser nutzt json_schema, und hin und wieder scheitert die Antwort an deiner Zod-Prüfung, weil total fehlt. Was sollte der Code tun?
Antwort anzeigenAntwort ausblenden
Prüfe zuerst, dass finish_reason gleich stop ist, denn eine abgeschnittene Antwort kann nicht gültig sein. Versuche es dann einmal mit dem Validierungsfehler im Prompt erneut, und wenn es wieder scheitert, gib einen sicheren Fehler zurück, statt zu raten. Erfasse Fehlschläge pro Modell und Schema-Version, damit du merkst, wenn eine Änderung an einem von beiden die Lage verschlechtert.
Das Wichtigste
json_schema für Daten, die du in einer festen Form brauchst, und validiere das Ergebnis immer in deinem eigenen Code, bevor du ihm vertraust.Weiterführende Links
Zuletzt geprüft am 17. November 2026