Persönliche API-Keys

Mit einem persönlichen API-Key erreichst du die Modelle deines Workspace auch außerhalb von Langdock, zum Beispiel in Coding-Tools wie Claude Code oder Codex oder in einem eigenen Projekt. Der Key authentifiziert sich als du: Er verbraucht dein Nutzungsbudget und erreicht ausschließlich die Completion-Endpunkte.

Bereich API-Schlüssel in den Account-Einstellungen mit dem Budget für Extra-Nutzung und dem Zeitpunkt der Zurücksetzung

Dein Admin muss dir zuerst Zugriff geben, bevor API-Schlüssel in deinen Account-Einstellungen auftaucht. Dieser Zugriff steuert, ob die Seite angezeigt wird. Die persönliche API-Nutzung zählt zu deinem effektiven Budget und zum Workspace-Ausgabenlimit. Wenn dein effektives persönliches Budget aufgebraucht ist, geben persönliche API-Anfragen einen Fehler zurück und verwenden kein Fallback-Modell. Sobald das Workspace-Ausgabenlimit erreicht ist, geben persönliche API-Anfragen ebenfalls einen Fehler zurück und verwenden kein Fallback-Modell. Dein Workspace-Admin muss das Limit erhöhen oder auf Unbegrenzt setzen. Alternativ musst du warten, bis der aktuelle Abrechnungszeitraum zurückgesetzt wird.

Persönlichen API-Key erstellen

API-Schlüssel öffnen

Gehe zu Einstellungen > Account > API-Schlüssel.

Key-Details eingeben

Bereich Deine API-Keys mit dem Button API-Key erstellen

Klicke auf API-Key erstellen. Gib dem Key einen Namen, der dir zeigt, wo du ihn einsetzt, damit du später weißt, welches Tool du aktualisieren musst, und wähle ein Ablaufdatum.

Key erstellen und kopieren

Dialog zum Erstellen eines neuen API-Keys mit Feldern für Name und Ablaufdatum und einer Übersicht, was der Key kann

Klicke auf API-Key erstellen, kopiere den Key und bewahre ihn sicher auf. Langdock zeigt ihn nur ein einziges Mal.

Teile einen persönlichen API-Key niemals mit anderen. Er authentifiziert sich als du und verbraucht dein Budget. Wer ihn hat, arbeitet also unter deinem Namen. Für gemeinsame Anwendungen und Automatisierungen nimm einen Workspace-API-Key. Wie du Keys sicher aufbewahrst, steht in den Best Practices für API-Schlüssel.

Auf der Seite siehst du außerdem, wie viel von deinem Budget du verbraucht hast und wann es zurückgesetzt wird. Wenn dein individuelles Limit aufgebraucht ist, geben persönliche API-Anfragen einen Fehler zurück und verwenden kein Fallback-Modell. Du kannst ein höheres Limit anfragen, sofern Nutzungslimit-Anfragen aktiviert sind, oder du fragst deinen Workspace-Admin. Wenn der Workspace sein Ausgabenlimit erreicht hat, reicht ein höheres individuelles Limit nicht aus. Dein Workspace-Admin muss das Workspace-Ausgabenlimit erhöhen oder auf Unbegrenzt setzen. Alternativ musst du warten, bis der aktuelle Abrechnungszeitraum zurückgesetzt wird.

Tool verbinden

Unter Deine Tools verbinden findest du die Einrichtung für Claude Code, Claude Desktop, OpenCode, Codex und direkte API-Aufrufe mit cURL. Mit demselben Key kannst du auch Cursor verbinden. Wähle ein verfügbares Modell aus, die Beispiele passen sich automatisch an, und folge dann der Anleitung für dein Tool. Die Anleitungen unten entsprechen dieser Einrichtung. Eine Übersicht der Langdock Completion APIs findest du in der API-Dokumentation. Ersetze YOUR_API_KEY durch deinen Key und your-model-id durch eine ID aus Verfügbare Modelle. Nutze eu oder us passend zur Modellregion deines Workspace. Für ein OpenAI-kompatibles Modell in der Region global nutze /openai/global/v1 und liste Modelle unter /openai/global/v1/models auf. In Dedicated Deployments beginnt die Basis-URL mit der Origin deines Deployments statt mit https://api.langdock.com.

Claude Code nutzt die Anthropic Messages API über Langdock.

Verfügbare Claude-Modelle prüfen

curl https://api.langdock.com/anthropic/eu/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Einstellungen hinterlegen

Füge dies in ~/.claude/settings.json ein (unter Windows: %USERPROFILE%\.claude\settings.json) und erstelle die Datei falls nötig. Ersetze die Modell-IDs durch welche aus dem vorherigen Schritt und stelle sicher, dass ANTHROPIC_API_KEY nicht gesetzt ist:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.langdock.com/anthropic/eu",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "your-model-id",
    "ANTHROPIC_SMALL_FAST_MODEL": "your-model-id"
  }
}

Claude Code starten

claude

Claude Code spricht die Anthropic Messages API, die Langdock unter der Base URL oben bereitstellt. Alle Anfragen laufen jetzt über deinen Workspace.

Claude Desktop kann Chats über Langdock-Modelle mit Third-Party Inference laufen lassen.

Developer Mode aktivieren

Öffne in Claude Desktop Help → Troubleshooting → Enable Developer Mode.

Gateway konfigurieren

Öffne Developer → Configure third-party inference. Setze Inference provider auf Gateway. Trage unter Gateway credentials Folgendes ein:

Gateway base URL:    https://api.langdock.com/anthropic/eu
Gateway API key:     YOUR_API_KEY
Gateway auth scheme: bearer
Credential kind:     Static API key

Testen und übernehmen

Lass Model discovery aktiviert und klicke auf Test connection und Test model discovery. Claude findet die in deinem Workspace verfügbaren Anthropic-Modelle. Klicke auf Save Changes und anschließend auf Apply Changes. Claude startet neu; wähle Continue with Gateway, falls du dazu aufgefordert wirst.

Für Cursor gibt es unter Deine Tools verbinden noch keine eigene Karte. Richte den OpenAI-Provider von Cursor auf Langdock aus:

Modell-Einstellungen öffnen

Öffne in Cursor Cursor Settings > Models.

Key und Basis-URL hinterlegen

Füge deinen persönlichen API-Key beim OpenAI-Provider ein und klicke auf Save. Aktiviere Override OpenAI Base URL und trage diese URL mit /v1 und ohne abschließenden Slash ein:

https://api.langdock.com/openai/eu/v1

Workspace-Modell hinzufügen

Gib die exakte ID eines Modells aus Verfügbare Modelle ein und klicke auf Add Custom Model. Wähle dieses Modell für den Chat.

Eigene API-Keys gelten in Cursor nur für Chat-Modelle. Tab nutzt weiterhin die integrierten Cursor-Modelle. Der Agent-Modus schlägt mit einem HTTP-400-Fehler fehl, weil die Chat Completions API von Langdock nur Tools vom Typ function akzeptiert. Für agentisches Coding nutze stattdessen Claude Code, Codex oder OpenCode.

Codex nutzt den OpenAI Responses-Endpunkt von Langdock (wire_api = "responses").

Config hinterlegen

Füge dies zu ~/.codex/config.toml hinzu (unter Windows: %USERPROFILE%\.codex\config.toml) und lege die Datei an, falls sie noch nicht existiert:

model = "your-model-id"
model_provider = "workspace"

[model_providers.workspace]
name = "Langdock"
base_url = "https://api.langdock.com/openai/eu/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

Codex starten

codex

Oder öffne die Codex-/ChatGPT-Desktop-App. Diese Datei speichert deinen Key auf diesem Computer. Wenn du den Rechner teilst, widerrufe den Key in Langdock und erstelle einen neuen.

OpenCode nutzt den Anthropic-kompatiblen Endpunkt über Langdock.

Config hinterlegen

Füge das zu opencode.json in deinem Projekt hinzu, oder zu ~/.config/opencode/opencode.json (unter Windows: %USERPROFILE%\.config\opencode\opencode.json). Unter models kannst du weitere Workspace-Modelle eintragen:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "workspace": {
      "npm": "@ai-sdk/anthropic",
      "name": "Langdock",
      "options": {
        "baseURL": "https://api.langdock.com/anthropic/eu/v1"
      },
      "models": {
        "your-model-id": { "name": "Your model" }
      }
    }
  }
}

OpenCode starten und verbinden

opencode

Führe /connect aus, wähle Other, gib workspace als Provider-ID ein und füge dann deinen API-Key ein.

Modell wählen

Wähle das Modell mit /models oder starte OpenCode direkt damit:

opencode --model workspace/your-model-id

Rufe die Completion-APIs direkt aus eigenen Projekten auf.

Verfügbare Modelle auflisten

curl https://api.langdock.com/openai/eu/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat-Completions-Anfrage senden

curl https://api.langdock.com/openai/eu/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model-id", "messages": [{"role": "user", "content": "Hello"}]}'

Oder die Anthropic-kompatible API nutzen

curl https://api.langdock.com/anthropic/eu/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model-id", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Nutze ein beliebiges OpenAI- oder Anthropic-kompatibles SDK und setze dessen Base URL auf die URLs oben. Die vollständigen Request-Formate stehen in der Chat Completions-, Responses- und Anthropic Messages-API-Dokumentation.

Dein Key funktioniert mit der OpenAI-kompatiblen Chat Completions API und der Responses API, der Anthropic Messages API, der Google Completion API und der Mistral Completion API. Welche davon du aufrufen kannst, hängt von den Modellen in deinem Workspace ab. Unter Verfügbare Modelle siehst du, was du für die integrierten Anleitungen für OpenAI und Anthropic auswählen kannst. Für Google und Mistral folgst du stattdessen der API-Dokumentation. Persönliche API-Keys funktionieren nur mit den Completion-Endpunkten. Für die Agent-, Embedding-, Knowledge Folder-, Integrations-, Skills-, Prompts-, Usage Export-, User Management- und Audit Logs APIs brauchst du einen Workspace-API-Key mit dem passenden Scope.

Key rotieren oder widerrufen

Öffne das Menü neben einem Key unter Deine API-Keys:

Key rotieren ersetzt das Secret und zeigt das neue nur einmal an. Das alte funktioniert sofort nicht mehr, aktualisiere also jedes verbundene Tool direkt.
Key widerrufen schaltet den Key endgültig ab.

Auch dein Workspace-Admin kann deine Keys widerrufen. Sie funktionieren außerdem nicht mehr, wenn dein Admin dir den Zugriff auf persönliche API-Keys entzieht oder deine Workspace-Mitgliedschaft deaktiviert.

Erste Schritte

Chat

Skills

Dateien

Agenten

Workflows

Integrationen

Microsoft Add-ins

Modelle & Limits

Anleitungen

Account

Ressourcen

Fehlerbehebung

Persönliche API-Keys

Persönlichen API-Key erstellen

Tool verbinden

Key rotieren oder widerrufen

​Persönlichen API-Key erstellen

​Tool verbinden

​Key rotieren oder widerrufen

Persönlichen API-Key erstellen

Tool verbinden

Key rotieren oder widerrufen