Zum Inhalt springen

API-Zugang

Mit einem API-Schlüssel nutzen Programme die KI-Modelle deines Workspace: Coding-Werkzeuge, Automatisierungen oder eigene Skripte. Ein Admin legt ihn unter Einstellungen → API-Zugang an; der Schlüssel wird dabei ein einziges Mal angezeigt. Fehlt der Bereich in den Einstellungen, ist der API-Zugang für deinen Workspace noch nicht freigeschaltet; dafür meldest du dich bei uns.

Werkzeug Basis-URL
OpenCode, Continue, Cline und alle anderen OpenAI-kompatiblen Programme https://chat.9brains.de/api/v1/openai
Claude Code https://chat.9brains.de/api/v1/anthropic

Als Modellname trägst du die Modell-ID ein, etwa gpt-6-luna oder claude-haiku-5-5-bedrock. Möglich sind nur Modelle, die in deinem Workspace freigeschaltet sind; einen anderen Namen lehnt 9brains mit einer Fehlermeldung ab.

In opencode.json im Projektordner, den Schlüssel in der Umgebungsvariablen NINEBRAINS_API_KEY:

{
"$schema": "https://opencode.ai/config.json",
"provider": {
"9brains": {
"npm": "@ai-sdk/openai-compatible",
"name": "9brains",
"options": {
"baseURL": "https://chat.9brains.de/api/v1/openai",
"apiKey": "{env:NINEBRAINS_API_KEY}"
},
"models": {
"gpt-6-luna": { "name": "GPT-6 Luna" }
}
}
},
"model": "9brains/gpt-6-luna"
}

Claude Code wird über Umgebungsvariablen eingestellt:

Terminal-Fenster
export ANTHROPIC_BASE_URL=https://chat.9brains.de/api/v1/anthropic
export ANTHROPIC_AUTH_TOKEN=9b_…
export ANTHROPIC_MODEL=claude-sonnet-5-5-bedrock
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5-bedrock

ANTHROPIC_MODEL ist das Modell, mit dem Claude Code arbeitet. ANTHROPIC_DEFAULT_HAIKU_MODEL nimmt es für kleine Nebenaufgaben; ohne diese Variable erledigt das Hauptmodell auch sie, und das kostet mehr.

Websuche und andere Werkzeuge, die beim KI-Anbieter laufen, gibt es über den API-Zugang nicht. Das Werkzeug WebSearch in Claude Code meldet deshalb einen Fehler; alles andere arbeitet normal.

In VS Code führen vier Wege zu 9brains. Alle brauchen nur den Schlüssel und eine Modell-ID.

Die Erweiterung Continue liest ~/.continue/config.yaml. In VS Code öffnest du die Datei über das Zahnrad oben in der Continue-Leiste, dann Configs und das Zahnrad neben Main Config:

name: 9brains
version: 1.0.0
schema: v1
models:
- name: GPT-6 Luna
provider: openai
model: gpt-6-luna
apiBase: https://chat.9brains.de/api/v1/openai
apiKey: 9b_…
useResponsesApi: false

Die Zeile useResponsesApi: false gehört zu jedem Modell. Ohne sie schickt Continue GPT-Modelle an eine Schnittstelle, die 9brains nicht anbietet, und meldet einen Fehler. Dateien legt Continue nur im Modus Agent an, den du links unter dem Eingabefeld wählst.

Beim ersten Start von Cline wählst du Bring my own API key, später findest du dieselben Felder über das Zahnrad oben in der Cline-Leiste:

  • API Provider: OpenAI Compatible
  • Base URL: https://chat.9brains.de/api/v1/openai
  • OpenAI Compatible API Key: dein Schlüssel
  • Model ID: etwa gpt-6-luna

Unter Model Configuration stellt Cline ein Kontextfenster von 128.000 Token ein; ist das Modell größer, trag seine Größe ein, sonst kürzt Cline Gespräche früher als nötig. Supports Images schaltest du bei Modellen ab, die keine Bilder verstehen. Die Kosten, die Cline anzeigt, bleiben bei 0 $, weil es die Preise nicht kennt; abgerechnet wird wie unter Abrechnung beschrieben.

Die Erweiterung Claude Code sieht Variablen aus deinem Terminal nur, wenn du VS Code aus diesem Terminal startest. Trag die Werte aus Claude Code deshalb in ~/.claude/settings.json ein, dann gelten sie in der Erweiterung und im Terminal:

{
"env": {
"ANTHROPIC_BASE_URL": "https://chat.9brains.de/api/v1/anthropic",
"ANTHROPIC_AUTH_TOKEN": "9b_…",
"ANTHROPIC_MODEL": "claude-sonnet-5-5-bedrock",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5-bedrock"
}
}

Eine Anmeldung bei Anthropic fragt die Erweiterung dann nicht mehr ab.

Der eingebaute Chat von VS Code nimmt 9brains-Modelle als eigenen Anbieter auf, auch ohne GitHub-Konto und ohne Copilot-Abo:

  1. Befehlspalette, Chat: Manage Language Models, dann Add Models und Custom Endpoint.
  2. Einen Namen wie 9brains und den Schlüssel eingeben, als API-Typ Chat Completions wählen.
  3. In der Datei chatLanguageModels.json, die VS Code danach öffnet, das Modell eintragen. Unter url steht hier die volle Adresse mit /chat/completions am Ende:
"id": "gpt-6-luna",
"name": "GPT-6 Luna",
"url": "https://chat.9brains.de/api/v1/openai/chat/completions",
  1. VS Code neu laden (Developer: Reload Window), dann erscheint das Modell in der Modellauswahl des Chats.

Ohne GitHub-Anmeldung gehen die Anfragen des Chats nur an 9brains. Bist du bei GitHub Copilot angemeldet, laufen Inline-Vorschläge, die semantische Suche und Nebenaufgaben wie Titel und Zusammenfassungen weiter über GitHub. Die Nebenaufgaben lenkst du mit den Einstellungen chat.utilityModel und chat.utilitySmallModel auf ein 9brains-Modell um. In Copilot Business und Enterprise kann die Organisation eigene Modelle abschalten.

Jedes Programm, das eine eigene Basis-URL für OpenAI zulässt, spricht 9brains über die OpenAI-kompatible Basis-URL an. In Python etwa mit der Bibliothek openai:

from openai import OpenAI
client = OpenAI(base_url="https://chat.9brains.de/api/v1/openai", api_key="9b_…")
answer = client.chat.completions.create(
model="gpt-6-luna",
messages=[{"role": "user", "content": "Fasse diesen Text in drei Sätzen zusammen: …"}],
)
print(answer.choices[0].message.content)

Über die API gibt es Text- und Bildeingaben mit Textantworten, auch mit Werkzeugaufrufen. Embeddings, Bilderzeugung und Spracherkennung bietet der API-Zugang nicht an.

Wie gründlich ein Modell nachdenkt, stellst du im Werkzeug ein; 9brains übersetzt die Angabe für jedes Modell in die passende Form. Schickt das Werkzeug keine, gilt die Voreinstellung des Modells in 9brains.

  • OpenCode: beim Modell "options": { "reasoningEffort": "low" }, etwa low oder high.
  • Claude Code: mit /effort oder der Umgebungsvariablen CLAUDE_CODE_EFFORT_LEVEL, etwa low oder high.

API-Aufrufe werden ausschließlich über das Guthaben deines Workspace abgerechnet. Bricht ein Werkzeug eine Antwort ab, wird sie trotzdem abgerechnet, denn das Modell schreibt sie zu Ende.

Ist das Guthaben aufgebraucht, lehnt 9brains jeden Aufruf ab, bis wieder Guthaben da ist. Hat ein Schlüssel ein Wochenlimit, lehnt 9brains seine Aufrufe ab, sobald es erreicht ist, bis Montag um 0:00 Uhr (Berlin) oder bis ein Admin das Limit anhebt. Das Werkzeug zeigt in beiden Fällen eine Fehlermeldung mit dem Grund.