Welche Endpunkte werden unterstützt?

OpenAI-kompatibel: /v1/models, /v1/chat/completions, /v1/responses, /v1/embeddings. Anthropic-kompatibel: /v1/messages und /v1/messages/count_tokens.

Brauche ich eine eigene SDK, um die API zu nutzen?

Nein. Verwenden Sie Ihre bestehende OpenAI- oder Anthropic-kompatible Client-Bibliothek – eine eigene SDK der AI Zentrale gibt es nicht.

Wie wird die API authentifiziert?

Über einen externen API-Schlüssel, den ein Administrator anlegt. Der Schlüssel wird als Bearer-Token oder als x-api-key mitgesendet.

Kann ich einen Schlüssel auf bestimmte Modelle begrenzen?

Ja. Jeder externe API-Schlüssel kann auf eine festgelegte Auswahl an Modellen beschränkt werden.

Zählt die API-Nutzung gegen das Chat-Budget?

Nein. Jeder externe API-Schlüssel hat ein eigenes Budget, das getrennt vom Chat-Budget der Organisation erfasst wird.

Unterstützt die API Streaming?

Ja. Antworten werden als Server-Sent Events unverändert durchgereicht.

API

Nutzen Sie Ihre KI-Modelle über eine zentrale API

Integrieren Sie Chat, Responses und Embeddings über kompatible Schnittstellen in eigene Anwendungen und Automatisierungen.

Loslegen Fragen klären

Funktionen

Was die API bietet

Ein genauerer Blick auf die einzelnen Bausteine.

OpenAI-kompatibel
/v1/models, /v1/chat/completions, /v1/responses und /v1/embeddings – nutzbar mit jedem Client, der die OpenAI-Schnittstelle spricht.
Anthropic-kompatibel
/v1/messages und /v1/messages/count_tokens – nutzbar mit bestehenden Anthropic-kompatiblen Clients, inklusive x-api-key-Authentifizierung.
Authentifizierung über externe API-Schlüssel
Administratoren legen eigene API-Schlüssel an – getrennt von der Anmeldung im Chat und getrennt vom Chat-Budget der Organisation.
Modell-Allowlist pro Schlüssel
Jeder Schlüssel kann auf eine bestimmte Auswahl an Modellen begrenzt werden, statt automatisch auf alle Modelle der Organisation zuzugreifen.
Eigenes Budget pro Schlüssel
Jeder Schlüssel erhält ein eigenes Ausgabenlimit, unabhängig vom Chat-Budget der Organisation.
Getrennte Verbrauchserfassung
Nutzung und Kosten werden pro Schlüssel erfasst – für Abrechnung und Beobachtung getrennt von anderen Zugriffswegen.
Streaming
Antworten werden als Server-Sent Events unverändert durchgereicht – geeignet für reaktionsschnelle Anwendungen mit laufender Ausgabe.
Bestehende Clients weiterverwenden
Verwenden Sie Ihre vorhandene OpenAI- oder Anthropic-kompatible Client-Bibliothek – eine eigene SDK ist nicht erforderlich.
n8n und Automatisierungen
Rufen Sie Modelle direkt aus n8n-Workflows oder anderen Automatisierungen auf, mit eigenem Schlüssel, eigener Modell-Freigabe und eigenem Budget.
Interne Anwendungen
Binden Sie eigene interne Tools und Anwendungen über dieselbe Schnittstelle an, ohne separate Infrastruktur aufzubauen.

API-Zugriff mit externem Schlüssel, Modell-Allowlist und eigenem Budget

Externe Schlüssel, Modell-Freigabe und Budget in einer Übersicht.

Anwendungsfälle

Wie Teams damit arbeiten

Automatisierungen

Modelle direkt aus n8n-Workflows heraus aufrufen.

Interne Werkzeuge

Eigene Anwendungen an dieselbe API anbinden.

Bestehende Clients

Vorhandene OpenAI- oder Anthropic-kompatible Bibliotheken weiterverwenden.

Beispiele

So rufen Sie die API auf

cURL

curl https://ihre-domain.de/v1/chat/completions \
  -H "Authorization: Bearer $AI_ZENTRALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude",
    "messages": [{"role": "user", "content": "Hallo"}]
  }'

JavaScript (OpenAI-Client)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AI_ZENTRALE_API_KEY,
  baseURL: "https://ihre-domain.de/v1",
});

const response = await client.chat.completions.create({
  model: "claude",
  messages: [{ role: "user", content: "Hallo" }],
});

Python (Anthropic-Client)

from anthropic import Anthropic

client = Anthropic(
    api_key="ihr-ai-zentrale-schluessel",
    base_url="https://ihre-domain.de",
)

message = client.messages.create(
    model="claude",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hallo"}],
)

FAQ