Skip to content

Strukturierte Ausgaben erstellen

POST
/v1/chat/completions
  • Mit response_format ein JSON Schema angeben, das die Ausgabestruktur des Modells einschränkt
  • Unterstützt json_schema-Modus mit strict: true für strikte Schema-Einhaltung
  • Nicht-Streaming-Antwort; schema-konforme Vervollständigung in einem Durchgang
  • Offizielle Dokumentation: Structured Outputs

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

Zu verwendendes Modell. Siehe Kompatibilitätstabelle der Modelle mit der Chat-API.

object[]
Required

Liste der bisherigen Nachrichten in der Unterhaltung.

Sampling-Temperatur zwischen 0 und 2. Höhere Werte (z. B. 0,8) machen die Ausgabe zufälliger; niedrigere (z. B. 0,2) fokussierter. In der Regel nur diesen oder top_p ändern, nicht beides.

Nucleus sampling alternative to temperature. The model considers tokens with top_p probability mass (e.g. 0.1 = top 10%). We generally recommend changing this or temperature, but not both.

Standard 1. Anzahl der Chat-Abschluss-Optionen pro Eingabenachricht.

Default false. For structured outputs, omit or set false to receive the full schema-compliant completion in one response.

Standard null. Bis zu 4 Sequenzen, bei denen die API keine weiteren Tokens erzeugt.

Default inf. Maximum tokens to generate in the completion.

Total length of input + output tokens is limited by the model context length.

Zahl zwischen -2,0 und 2,0. Positive Werte bestrafen neue Tokens nach bisherigem Vorkommen im Text und fördern neue Themen. Mehr zu Strafen

Standard 0. Zwischen -2,0 und 2,0. Positive Werte bestrafen nach Häufigkeit im Text und reduzieren Wiederholungen.

Modify the likelihood of specified tokens appearing in the completion.
Accepts a JSON object mapping token IDs to bias values from -100 to 100. Applied to logits before sampling; effect varies by model.

Eindeutige Kennung des Endnutzers. Hilft OpenAI bei Missbrauchserkennung. Mehr erfahren

Objekt zur Angabe des Ausgabeformats. { "type": "json_object" } aktiviert den JSON-Modus. Im JSON-Modus muss das Modell auch per System-/User-Nachricht zum JSON-Erzeugen angewiesen werden. Mit json_schema Schema und optional strict: true für Structured Outputs.

Beta. Wenn gesetzt, versucht das System deterministisch zu sampeln; Änderungen über system_fingerprint in der Antwort beobachten.

Liste von Tools, die das Modell aufrufen kann. Derzeit nur Funktionen als Tools.

Steuert Funktionsaufrufe: none = keiner; auto = Modell wählt; erzwingen mit {"type": "function", "function": {"name": "my_function"}}. Standard none ohne Funktionen, sonst auto.

Responses

application/json
object
object[]
Required
object
Required

Playground

Authorization
Body

Samples