Quinta einbinden: die OpenAI-base_url umstellen
twenty5ai · 14. Juli 2026 · 6 Min. Lesezeit
Quinta spricht dieselbe Sprache wie die OpenAI-API. Das heißt: Sie müssen Ihre Anwendungen nicht neu schreiben, um von einem Cloud-Dienst auf Ihre eigene, souveräne KI umzustellen. Es genügt, eine einzige Einstellung zu ändern — die base_url.
Das Prinzip: nur die Adresse ändert sich
Jeder OpenAI-kompatible Client schickt seine Anfragen an eine base_url. Standardmäßig zeigt diese auf die Server von OpenAI. Setzen Sie die base_url stattdessen auf Ihre Quinta-Instanz, gehen dieselben Anfragen an Ihre eigene Infrastruktur — und werden dort von den Modellen beantwortet, die Sie auf Ihrer Hardware betreiben.
Konkret ändern Sie nur zwei Werte:
- die base_url — sie zeigt auf den Endpunkt Ihrer Quinta-Instanz (endet auf /v1),
- den API-Schlüssel — den Ihr Quinta-Dashboard ausstellt, nicht den von OpenAI.
Der Modellname stammt aus Ihrem Quinta-Katalog. Sonst bleibt Ihr Code unverändert — alle Aufrufe, Bibliotheken und Werkzeuge funktionieren weiter.
Zur Klarstellung: Sie leiten damit nicht Ihren OpenAI-Verkehr „durch“ Quinta. Sie ersetzen den Endpunkt — die Anfragen gehen an Quinta statt an OpenAI und werden von Ihren lokalen Modellen beantwortet. Kein Byte verlässt das Haus.
Wo Sie base_url und Schlüssel finden
Beide Werte stehen in Ihrem Quinta-Dashboard. Die Endpunkt-URL hat die Form https://quinta.ihre-domain.example/v1 (Ihre tatsächliche Domain), der API-Schlüssel wird pro Nutzer oder Anwendung vergeben und lässt sich dort auch wieder entziehen.
In wenigen Zeilen umgestellt
Wählen Sie Ihre Sprache oder Ihr Framework. Es ist jeweils dieselbe Umstellung — base_url und Schlüssel auf Quinta zeigen lassen:
from openai import OpenAI
client = OpenAI(
base_url="https://quinta.ihre-domain.example/v1",
api_key="QUINTA_API_KEY",
)
response = client.chat.completions.create(
model="llama-3.1-8b-instruct",
messages=[{"role": "user", "content": "Hallo Quinta!"}],
)
print(response.choices[0].message.content)Ohne Codeänderung: über Umgebungsvariablen
Wenn Sie den Code gar nicht anfassen möchten: Die offiziellen OpenAI-Bibliotheken (Python und Node) lesen die base_url und den Schlüssel automatisch aus Umgebungsvariablen. Setzen Sie diese, und Ihre bestehende Anwendung spricht mit Quinta — ohne eine Zeile Code zu ändern.
export OPENAI_BASE_URL="https://quinta.ihre-domain.example/v1"
export OPENAI_API_KEY="QUINTA_API_KEY"Der genaue Variablenname kann je nach SDK abweichen; die offiziellen OpenAI-Bibliotheken nutzen OPENAI_BASE_URL und OPENAI_API_KEY.
Prüfen, ob es läuft
Ein schneller Test: Fragen Sie die verfügbaren Modelle ab. Kommt eine Antwort von Ihrer Quinta-Instanz zurück, ist die Umstellung erfolgreich.
curl https://quinta.ihre-domain.example/v1/models \
-H "Authorization: Bearer $QUINTA_API_KEY"Was das für Ihre Daten bedeutet
Ab dem Moment, in dem die base_url auf Quinta zeigt, verlassen Ihre Prompts und die Antworten Ihre Infrastruktur nicht mehr. Aus einem externen Cloud-Aufruf wird eine Anfrage, die vollständig unter Ihrer Kontrolle bleibt — die Grundlage für DSGVO, EU AI Act und NIS2. Dieselbe API, dieselben Werkzeuge, aber Ihre Daten bleiben bei Ihnen.
Die genauen Werte — Endpunkt-URL, API-Schlüssel und die verfügbaren Modellnamen — finden Sie in Ihrem Quinta-Dashboard. Bei der Einführung unterstützt Sie unser Team.
Wir binden Ihre Anwendungen mit Ihnen an.
In der Demo stellen wir gemeinsam eine erste Anwendung auf Ihre Quinta-Instanz um — von der base_url bis zur ersten produktiven Antwort.