Completions

OpenAI-kompatible API-Endpunkte

Achtung

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
  • 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

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.

posthttps://app.meingpt.com/api/openai/v1/chat/completions

Chat-Vervollständigung erstellen

Erstellt eine Modellantwort für die gegebene Chat-Konversation. Kompatibel mit OpenAIs Chat Completions API.

🔒 ApiKeyAuth

Parameter

ParameterInTypBeschreibung
Authorization*headerstringAPI-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Request Body · application/json

FeldTypBeschreibung
messages*Array<ChatMessage>Liste der bisherigen Nachrichten der Konversation
model*stringID des zu verwendenden Modells
response_formatobject
streambooleanOb Teilergebnisse zurückgestreamt werden sollen
temperaturenumberSampling-Temperatur
toolsArray<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" | objectSteuert, welches Tool aufgerufen wird – 'auto', 'none', 'required' oder eine bestimmte Funktion.

Responses

200Erfolgreiche Antwort
FeldTypBeschreibung
idstringEindeutige Kennung für die Chat-Vervollständigung
objectstring
creatednumberUnix-Zeitstempel
modelstringVerwendetes Modell
choicesArray<object>
usageUsage
400Ungültige Anfrage – ungültige Eingabe
FeldTypBeschreibung
statusstring
messagestring
401Nicht autorisiert – fehlender oder ungültiger API-Schlüssel
FeldTypBeschreibung
statusstring
messagestring
403Verboten – Completions-API ist für die Organisation nicht aktiviert
FeldTypBeschreibung
statusstring
messagestring
500Interner Serverfehler
FeldTypBeschreibung
statusstring
messagestring
War diese Seite hilfreich?