Zum Hauptinhalt springen
Erstelle mit POST /openai/{region}/v1/responses eine Modellantwort. Langdock unterstützt die OpenAI-Responses-Request- und Response-Form für die unten genannten Felder. Du kannst daher die OpenAI-SDK-Methode responses.create und andere Responses-kompatible Clients mit einem Langdock API-Key verwenden. Nutze diesen Endpunkt für Codex und andere Clients, die Responses-input-Elemente senden und Responses-output-Elemente lesen. Für Integrationen, die messages senden und choices auslesen, verwende OpenAI Chat Completions.

Bevor du startest

  • API-Key: Erstelle einen persönlichen API-Key oder frage deinen Workspace-Admin nach einem Workspace-API-Key mit dem Scope Completion API.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Parameter

Übergebe einen String, Nachrichtenelemente oder Tool-Ergebnisse in input. Langdock leitet unterstützte Werte für instructions, max_output_tokens, temperature, top_p, reasoning, text, metadata, include, truncation, service_tier, tools, tool_choice und parallel_tool_calls weiter. Der Endpunkt unterstützt natives Streaming mit Server-Sent Events und Function Tools, einschließlich paralleler Function Calls. Welche Einstellungen greifen, hängt vom ausgewählten Modell ab. Der Pfadwert {region} muss eu, us, global oder ch sein und zur Region passen, in der dein Modell verfügbar ist. Rufe GET /openai/{region}/v1/models mit derselben Region auf, um die in deinem Workspace verfügbaren Modelle aufzulisten. Wenn dein Workspace Bring your own key (BYOK) verwendet, können andere Modelle verfügbar sein.

Unterschiede zur OpenAI API

Langdock speichert keinen Zustand für die Responses API. Sende den vollständigen Gesprächsverlauf mit jeder Anfrage.
  • Lasse store weg oder setze den Wert auf false. store=true wird abgelehnt.
  • previous_response_id wird nicht unterstützt und abgelehnt. Übergebe vorherige Nachrichten und Tool-Ergebnisse in input.
  • Background Responses werden nicht unterstützt. Lasse background weg oder setze den Wert auf false.
  • Gehostete Tools wie Web-Suche, File Search, Code Interpreter, Bildgenerierung, Computer Use und MCP werden nicht unterstützt.
  • Function Tools werden unterstützt, einschließlich paralleler Function Calls.

OpenAI-Python-Bibliothek verwenden

Lege Langdock als Basis-URL fest und verwende responses.create:

Response streamen

Setze stream=True, um native Events der Responses API zu erhalten:

Zustandslose Unterhaltung mit Tool-Aufruf fortsetzen

Füge die zurückgegebenen Output-Elemente und das passende function_call_output zur nächsten Anfrage hinzu:

Codex verbinden

Erstelle einen persönlichen API-Key und öffne dann Deine Tools verbinden > Codex unter Einstellungen > Account > API-Keys. Wähle ein verfügbares OpenAI-kompatibles Modell und folge den generierten Schritten für dein Betriebssystem. Die Einrichtung zeigt Codex auf den Responses-Endpunkt von Langdock (wire_api = "responses") und dein ausgewähltes Modell.

Rate Limits

Die Standard-Limits sind 500 RPM (Anfragen pro Minute) und 150.000 TPM (Tokens pro Minute).
  • RPM wird je Workspace, Modell und API-Key begrenzt.
  • TPM teilen sich alle API-Keys, die dasselbe Modell in einem Workspace verwenden.
  • In der Cloud können Admins unter Einstellungen > Workspace > Produkte > API die TPM für eigene Modelle setzen; sie begrenzt die geschätzte Größe einer einzelnen Anfrage.
  • In Dedicated Deployments können Admins unter Einstellungen > Workspace > Produkte > API eigene Limits je Modell festlegen.
Bei einer Überschreitung erhältst du 429 Too Many Requests. Erfolgreiche Antworten und Antworten mit Rate-Limit-Fehler enthalten die Response-Header x-ratelimit-limit-requests, x-ratelimit-limit-tokens, x-ratelimit-remaining-requests und x-ratelimit-remaining-tokens. Die Nutzung persönlicher API-Keys zählt zusammen mit Chat- und Agenten-Nutzung zum effektiven persönlichen Budget des Mitglieds und zum Workspace-Ausgabenlimit. Die Nutzung von Workspace-API-Keys zählt zum API-Spend-Limit des Workspace. Siehe Persönliche API-Keys und Preise.
Browser- und CORS-Integrationen werden nicht unterstützt. Bewahre API-Keys serverseitig auf und rufe den Endpunkt über einen Server, eine CLI oder ein lokales Entwicklungstool auf. Weitere Informationen findest du in den Best Practices für API-Keys.