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.
Basis-URL
Abschnitt betitelt „Basis-URL“| 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.
OpenCode
Abschnitt betitelt „OpenCode“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
Abschnitt betitelt „Claude Code“Claude Code wird über Umgebungsvariablen eingestellt:
export ANTHROPIC_BASE_URL=https://chat.9brains.de/api/v1/anthropicexport ANTHROPIC_AUTH_TOKEN=9b_…export ANTHROPIC_MODEL=claude-sonnet-5-5-bedrockexport ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5-bedrockANTHROPIC_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.
VS Code
Abschnitt betitelt „VS Code“In VS Code führen vier Wege zu 9brains. Alle brauchen nur den Schlüssel und eine Modell-ID.
Continue
Abschnitt betitelt „Continue“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: 9brainsversion: 1.0.0schema: v1models: - name: GPT-6 Luna provider: openai model: gpt-6-luna apiBase: https://chat.9brains.de/api/v1/openai apiKey: 9b_… useResponsesApi: falseDie 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.
Claude Code in VS Code
Abschnitt betitelt „Claude Code in VS Code“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.
Chat in VS Code (GitHub Copilot)
Abschnitt betitelt „Chat in VS Code (GitHub Copilot)“Der eingebaute Chat von VS Code nimmt 9brains-Modelle als eigenen Anbieter auf, auch ohne GitHub-Konto und ohne Copilot-Abo:
- Befehlspalette, Chat: Manage Language Models, dann Add Models und Custom Endpoint.
- Einen Namen wie
9brainsund den Schlüssel eingeben, als API-Typ Chat Completions wählen. - In der Datei
chatLanguageModels.json, die VS Code danach öffnet, das Modell eintragen. Unterurlsteht hier die volle Adresse mit/chat/completionsam Ende:
"id": "gpt-6-luna","name": "GPT-6 Luna","url": "https://chat.9brains.de/api/v1/openai/chat/completions",- 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.
Eigene Programme und Automatisierungen
Abschnitt betitelt „Eigene Programme und Automatisierungen“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.
Denkstufe
Abschnitt betitelt „Denkstufe“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" }, etwalowoderhigh. - Claude Code: mit
/effortoder der UmgebungsvariablenCLAUDE_CODE_EFFORT_LEVEL, etwalowoderhigh.
Abrechnung
Abschnitt betitelt „Abrechnung“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.