Zum Inhalt springen
souveraen.ai
Entwickler-API

Ihr Wissen und Ihre Agenten, per API.

Eine OpenAI-kompatible Schnittstelle auf Ihrem eigenen Mandanten. Ihre Anwendungen fragen Modelle ab, bekommen Antworten mit Quellenangabe aus Ihrem Wissen und starten veröffentlichte Agenten. Zugriffsrechte und Freigaben gelten wie in der Oberfläche.

  • OpenAI-kompatibel
  • Hosting in Deutschland
  • Schlüssel je Person oder Arbeitsbereich

chat.py

from openai import OpenAI

client = OpenAI(
    base_url="https://ihr-mandant.cust.souveraen.ai/v1",
    api_key="sk-svr-…",
)

answer = client.chat.completions.create(
    model="souveraen-auto",
    messages=[{"role": "user", "content": "Fasse den Vertrag in drei Sätzen zusammen."}],
)

Das offizielle OpenAI-SDK, nur mit anderer Basis-URL.

Endpunkte

Eine Schnittstelle für Modelle, Wissen und Agenten.

Bestehende Werkzeuge und Bibliotheken, die mit der OpenAI-Schnittstelle arbeiten, brauchen nur eine neue Basis-URL und einen Schlüssel.

Chat Completions
Mit und ohne Streaming, mit Werkzeugaufrufen und strukturierten Antworten. Das Modell wählen Sie selbst oder überlassen es souveraen-auto.
Antworten aus Ihrem Wissen
Das Modell souveraen-wissen durchsucht Ihre angebundenen Quellen und liefert die Quellenangaben als Feld in der Antwort mit.
Embeddings
Vektoren für eigene Suchen und Auswertungen, über denselben Schlüssel und dieselbe Abrechnung.
Agenten-API
Veröffentlichte Agenten auflisten, starten, verfolgen und abbrechen. Erreichbar ist nur, was Sie je Agent freischalten.
Signierte Rückmeldungen
Auf Wunsch meldet ein Lauf sein Ergebnis an Ihre Adresse zurück, mit Signatur zum Nachprüfen. Den Verlauf gibt es auch als Ereignisstrom.

Schlüssel und Kontrolle

Jeder Schlüssel hat einen Besitzer, ein Budget und ein Protokoll.

Ein Schlüssel kann nie mehr als die Person oder der Arbeitsbereich, zu dem er gehört. Was er darf, legen Sie beim Anlegen fest.

Sicherheit im Detail
Persönliche Schlüssel
Handeln als die Person, mit ihren aktuellen Zugriffsrechten. Ändern sich die Rechte, ändert sich auch, was der Schlüssel sieht.
Schlüssel je Arbeitsbereich
Ein Dienstzugang für genau einen Arbeitsbereich, angelegt von dessen Verwaltern. Geeignet für Anwendungen ohne eigene Person.
Umfang und Limit
Je Schlüssel wählen Sie, ob er Modelle, Wissen, Embeddings oder Agenten nutzen darf, und wie viele Anfragen pro Minute erlaubt sind.
Monatsbudget
Ein Schlüssel kann ein eigenes Monatsbudget an KI-Guthaben bekommen. Ist es verbraucht, antwortet die API mit einem klaren Fehler.
IP-Freigabeliste und Ablauf
Beschränken Sie einen Schlüssel auf Ihre Adressbereiche und geben Sie ihm ein Ablaufdatum. Das Geheimnis wird nur einmal angezeigt.
Nutzung und Protokoll
Jeder Aufruf wird je Schlüssel gezählt und protokolliert: Endpunkt, Modell und Verbrauch, ohne Inhalte.

In jedem Plan

Die API gehört dazu, auch im Free-Plan.

Aufrufe verbrauchen dasselbe KI-Guthaben wie die Arbeit in der Oberfläche. Eine eigene API-Gebühr gibt es nicht.

Je Plan

OpenAI-kompatible API
Agenten-API
Aktive Schlüssel je Person
Anfragen pro Minute
Budget und Limit je Schlüssel
Nutzung je Schlüssel einsehbar

Free

Pro

Max

Ja
Ja
Ja
Ja
Ja
Ja
1
10
25 bis 50
10
60
120 bis 300
Ja
Ja
Ja
Ja
Ja
Ja

Max: 25 Schlüssel und 120 Anfragen pro Minute bei Max 5×, 50 Schlüssel und 300 Anfragen bei Max 20×. Gilt für On Demand.

Fragen

Was Entwickler vorher wissen wollen.

Zu Kompatibilität, Rechten und Abrechnung.

Ein konkretes Vorhaben?

Sagen Sie uns, welches System Sie anbinden wollen. Wir klären, welcher Weg passt. Telefon (03744) 365 2202.

Gespräch vereinbaren

Modelle, Chat Completions mit Streaming und Werkzeugaufrufen sowie Embeddings folgen dem OpenAI-Format, einschließlich der Fehlermeldungen. Sie nutzen das offizielle SDK mit einer anderen Basis-URL. Die Responses-Schnittstelle wird nicht angeboten.

Selbst ausprobieren

Der erste Aufruf braucht nur einen Schlüssel.

Legen Sie ein Konto an, erzeugen Sie einen Schlüssel und tragen Sie die Basis-URL in Ihre Anwendung ein. Im Free-Plan ist die API enthalten.

  1. Konto anlegen1
  2. Schlüssel erzeugen2
  3. Basis-URL eintragen3