Der API-Zugang ist ein Zugang zu den KI-Modellen ohne den KI-Workplace. Du sprichst die Modelle direkt aus eigenen Programmen, Skripten oder Automatisierungen an, zum Beispiel aus n8n, einem Monitoring-Skript oder einer eigenen Anwendung.

Der Workplace dient dabei nur einem Zweck: Dort richtest du die Zugangsschlüssel ein und verwaltest sie. Die Aufrufe selbst laufen nicht über den Workplace.

⚠️ Für Admins und Entwickler:innen: API-Keys legst du im Admin-Bereich an, dafür brauchst du Administrator-Rechte. Für die normale Arbeit im Chat ist davon nichts nötig.

Voraussetzungen

  • Ein gebuchter KI-Workplace. Im Testzeitraum steht der API-Zugang nicht zur Verfügung.
  • Administrator-Rechte in eurem Workplace.

API-Key einrichten

Navigiere zu Einstellungen > API-Keys im Admin-Bereich.

  1. Klick auf + Key erstellen
  2. Gib einen aussagekräftigen Namen ein, zum Beispiel „n8n-Produktion” oder „Monitoring-Skript”
  3. Lass die Option Aktiv eingeschaltet
  4. Bestätige mit Erstellen

Der Key erscheint anschließend in der Tabelle und lässt sich dort jederzeit wieder einblenden und kopieren.

⚠️ Pflichtschritt: Modelle freigeben. Ein frisch erstellter Key ist keinem Modell zugeordnet und damit nicht nutzbar. Öffne über das Einstellungen-Symbol oder den Modelle-Badge den Quota-Dialog und leg fest, welche Modelle der Key aufrufen darf: entweder alle oder einzeln ausgewählte. Ohne diesen Schritt liefert jeder Aufruf einen Fehler zurück.

💡 Geheimhaltung: Behandle einen API-Key wie ein Passwort. Leg ihn in einem Passwort-Manager oder als Umgebungsvariable ab und gib ihn nie in öffentlichen Repositories oder Chat-Nachrichten weiter.

Empfehlung: Leg pro Anwendung einen eigenen Key an. So kannst du einzelne sperren, ohne alle übrigen Integrationen neu einrichten zu müssen.

Keys lassen sich außerdem vorübergehend deaktivieren, umbenennen und löschen. Wie das im Einzelnen funktioniert, steht in den Admin-Einstellungen.

Technische Dokumentation

Wie die Aufrufe konkret aussehen, also Basis-Adresse, Endpunkte, Parameter und Antwortformate, steht in der technischen Referenz unter docs.adacor.ai.

Dort findest du zu jedem Endpunkt fertige Codebeispiele für Shell, Node, Python, Ruby und PHP. Über „Try It!” lässt sich jeder Aufruf direkt auf der Seite ausprobieren, ohne selbst etwas zu programmieren. Neben den Chat-Modellen sind dort auch die Bereiche Whisper, Embeddings, Tokenizer und Markdown dokumentiert.

Die Schnittstelle folgt teilweise dem OpenAI-Standard. Wer bereits mit gängigen Bibliotheken für dieses Format arbeitet, kommt damit meist ohne größeren Umbau zurecht. Die Referenz weist allerdings selbst darauf hin, dass einzelne Funktionen deutlich abweichen können.

📌 Kein Zusammenhang mit OpenAI-Modellen: Der Standard beschreibt nur das Format der Schnittstelle. Über den API-Zugang erreichst du die Modelle des KI-Workplace, nicht die von OpenAI.

Abrechnung

Der Zugang kostet nichts extra, er ist im Lizenzpreis enthalten. Was du über die API verbrauchst, wird nach tatsächlichem Volumen abgerechnet und monatlich in Rechnung gestellt.

Abgerechnet wird je nach Leistung unterschiedlich:

LeistungAbrechnung nach
SprachmodelleToken, getrennt nach Eingabe und Ausgabe
EmbeddingsToken
Sprache zu TextStunden
Markdown-Konvertierung für DokumenteSeiten

Die konkreten Preise je Modell stehen auf der Preisseite im Abschnitt „Was extra kostet”. Klapp dort „Verbrauchspreise über die Adacor-API” auf, darin stehen die Sätze für jedes einzelne Modell.

📌 Verbrauch derzeit nicht im Workplace einsehbar: Aufrufe über API-Keys erscheinen nicht unter Administration > Nutzung. Diese Statistik zählt nur, was über den Workplace selbst läuft, also Chat, Agenten, Suche und Indexierung. Eine Aufschlüsselung der API-Verbräuche ist in Vorbereitung. Bis dahin siehst du sie erst auf der monatlichen Rechnung.

Verwandte Guides