Unsere API unterstützt nicht alle Parameter, die OpenAI anbietet. Anfragen
werden trotzdem akzeptiert und verarbeitet, jedoch werden nicht alle Parameter
beachtet.
Unterstützte Parameter:
model
messages
response_format (nur { "type": "json_object" } oder { "type": "text" } — OpenAIs json_schema/Strict Structured Outputs wird aktuell nicht unterstützt)
stream
temperature
tools
tool_choice
Der Reasoning-Effort bzw. das Reasoning-Level (z. B. OpenAIs reasoning_effort) lässt sich über die API derzeit nicht einstellen — Reasoning-Modelle verwenden bei API-Anfragen ihr Standard-Effort-Level.
Der content-Wert einer Nachricht muss reiner Text (String) sein — die API akzeptiert aktuell keine Bilder, Dateien oder sonstigen Anhänge (z. B. image_url-Content-Blöcke) in Chat-Completion-Anfragen. Für den Versand von Dateien oder Bildern stehen stattdessen die Assistant- bzw. Workflow-Ausführung über die API zur Verfügung.
Hinweis
Für schema-validierte JSON-Ausgaben ohne OpenAIs json_schema-Modus kannst Du stattdessen ein Tool definieren, dessen parameters das gewünschte JSON Schema sind, und tool_choice auf diese Funktion setzen ({"type": "function", "function": {"name": "..."}}). Das Modell ruft die Funktion dann mit Argumenten auf, die dem Schema entsprechen — Du liest die JSON-Daten aus tool_calls[0].function.arguments statt aus content.
Hinweis
Reasoning-Modelle verwenden intern einen festen temperature-Wert und können andere Werte ablehnen. Wenn du bei diesen Modellen einen Fehler erhältst, lasse temperature in der Anfrage weg oder entferne einen eventuellen Client-seitigen Standardwert.
Hinweis
Nicht jedes Modell, das Du im meinGPT-Chat siehst, ist automatisch über die API nutzbar. Welche Modelle für Deine Organisation freigeschaltet sind, legt ein Workspace-Admin fest (siehe Workspace-Konfiguration).
Rufe GET /models/v1 auf, um die exakte Liste der für Deinen API-Schlüssel freigeschalteten Modelle abzurufen, und verwende genau den Wert aus dem id-Feld als model in Deiner Anfrage.
Schickst Du einen model-Wert, der für Deine Organisation nicht freigeschaltet ist, antwortet die API mit 403 Forbidden und einer Fehlermeldung der Form:
{ "status": "error", "message": "Model 'dein-modell-id' is not enabled for this organization."}
Diese Meldung unterscheidet sich vom allgemeinen 403-Fehler "Completions-API ist für die Organisation nicht aktiviert" (der die gesamte Completions-API betrifft, nicht ein einzelnes Modell). Kostenlose Modelle (aktuell GPT-5 Nano, API-ID gpt-5-nano) sind von dieser Einschränkung ausgenommen und immer verfügbar.
Erstellt eine Modellantwort für die gegebene Chat-Konversation. Kompatibel mit OpenAIs Chat Completions API.
🔒 ApiKeyAuth
Parameter
Parameter
In
Typ
Beschreibung
Authorization*
header
string
API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
Request Body · application/json
Feld
Typ
Beschreibung
messages*
Array<ChatMessage>
Liste der bisherigen Nachrichten der Konversation
model*
string
ID des zu verwendenden Modells
response_format
object
stream
boolean
Ob Teilergebnisse zurückgestreamt werden sollen
temperature
number
Sampling-Temperatur
tools
Array<object>
Tools (Funktionen), die das Modell aufrufen darf. Nicht jedes Modell unterstützt Tool Calling – eine Anfrage mit Tools an ein nicht unterstütztes Modell (z. B. Perplexity) liefert 400.
tool_choice
"auto" | "none" | "required" | object
Steuert, welches Tool aufgerufen wird – 'auto', 'none', 'required' oder eine bestimmte Funktion.
Responses
200Erfolgreiche Antwort
Feld
Typ
Beschreibung
id
string
Eindeutige Kennung für die Chat-Vervollständigung
object
string
created
number
Unix-Zeitstempel
model
string
Verwendetes Modell
choices
Array<object>
usage
Usage
400Ungültige Anfrage – ungültige Eingabe
Feld
Typ
Beschreibung
status
string
message
string
401Nicht autorisiert – fehlender oder ungültiger API-Schlüssel
Feld
Typ
Beschreibung
status
string
message
string
403Verboten – Completions-API ist für die Organisation nicht aktiviert