Mit strukturierten Ausgaben kannst du maschinenlesbares Format statt Freitext vorgeben.
Unterstützte Endpunkte
Verwende strukturierte Ausgaben mit:
/v1/chat/completions mit response_format
/v1/responses mit text.format
/v1/messages kann weiterhin JSON-Text zurückgeben, verwendet aber nicht denselben response_format-Vertrag.
Anfrage
Antwort
Hinweise zum Vertrag
response_format.type muss text, json_object oder json_schema sein.
- Füge bei
json_schema ein Schemaobjekt ein (response_format.json_schema.schema bei Chat-ähnlichen Payloads oder text.format.schema bei Responses-ähnlichen Payloads).
- Validiere das JSON auf deinem Server, bevor du es weiterverwendest.
Schema entwerfen
Beginne mit einem kleinen Objekt, kennzeichne Pflichtfelder ausdrücklich und nutze Aufzählungen für bekannte Kategorien. Setze additionalProperties: false, um zusätzliche Schlüssel abzulehnen. Halte das angeforderte Schema und die Servervalidierung synchron und versioniere sie gemeinsam.
Ergebnis validieren
Parse und validiere das vollständige Ergebnis vor der weiteren Nutzung. Dieses TypeScript-Beispiel verwendet Zod und entspricht dem Wetterschema oben:
Behandle Ablehnungen, fehlende Inhalte und abgeschnittene Antworten vor dem Parsen. Bei fehlgeschlagener Validierung sind nur begrenzte Korrekturversuche zulässig; gib danach einen sicheren Fehler zurück. Erneute Generierungen können zusätzliche Kosten verursachen. Gültiges JSON belegt weder sachliche Richtigkeit noch die Erlaubnis zu einer Aktion.
Erfasse Validierungsfehler nach Modell und Schemaversion. Prüfe deine Bewertungsfälle erneut, wenn sich eines davon ändert. Zur Wiederherstellung fehlerhaften JSONs siehe Antwortreparatur. Zuletzt geändert am 2. Oktober 2026