Skip to main content
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