Auf dieser Seite erfahren Sie, was ein API-Key ist, wie Sie diesen für RWTHgpt erstellen und für den Zugriff auf die verfügbaren KI:connect-Modelle über die API (Application Programming Interface) einsetzen.

Ein API-Key ist ein geheimer Zugriffsschlüssel, der es Anwendungen ermöglicht, sicher auf einen Chatbot-Dienst zuzugreifen. Er dient der Identifikation und Authentifizierung von Anfragen, regelt Berechtigungen und ermöglicht die Kontrolle sowie Zuordnung der Nutzung. API-Keys werden verwendet, um Chatbots in eigene Anwendungen, Websites oder interne Systeme zu integrieren und müssen vertraulich behandelt werden.

Die KI:connect-API ist OpenAI-kompatibel. Dadurch kann beispielsweise das OpenAI-SDK mit angepasster Base-URL verwendet werden. Die API ist unter der Base-URL https://chat.kiconnect.nrw/api/v1 erreichbar. Die Authentifizierung erfolgt über einen Bearer Token, wobei der API-Key im HTTP-Header (Authorization: Bearer <API-Key>) übergeben wird.

Um einen API-Key zu generieren, folgen Sie bitte nachfolgenden Schritten:

Schritt 1
Melden Sie sich in der KI:connect-Weboberfläche via RWTH Single Sign-On an.

Schritt 2
Klicken Sie am unteren linken Rand auf Ihren Namen (1) und wählen Sie API-Schlüsselverwaltung (2) aus.

Schritt 3
Klicken Sie nun auf Schlüssel erstellen (3)
Es wird ein personalisierter API-Key erstellt.
Den Namen können Sie falls gewünscht selbst unter Schlüsselname (4) vergeben. 

Über das Informationssymbol (5) gelangen Sie zur externen KI:connect API-Dokumentation. Dort finden Sie Informationen zu den unterstützten API-Endpunkten (z. B. chat/completions, responses, embeddings und models) sowie zu den aktuell unterstützten Modellen.

Hinweise zur Nutzung

API-Anfragen zählen gegen dieselben Limits wie die Nutzung über die Web-Oberfläche – es gibt kein separates Kontingent. Das bedeutet, dass sowohl Gruppen-, Token- als auch Kostenlimits Ihrer Nutzendengruppe gleichermaßen für API-Requests gelten. Zusätzlich ist die Anzahl paralleler Anfragen pro Person begrenzt. Nutzende, die Mitglied mehrerer Nutzendengruppen sind, können für den API-Schlüssel festlegen, auf welche Nutzendengruppe die Nutzung der KI-Modelle angerechnet wird.

Virtuelle API-Schlüssel besitzen eine Laufzeit von einem Monat. Nach Ablauf müssen sie über die Funktion „Rotieren“ erneuert werden. Dabei wird ein neuer Schlüssel erzeugt. Abgelaufene Schlüssel können nicht weiter verwendet werden.

Welche Modelle aktuell für die API-Nutzung verfügbar sind und welcher Anzeigename per API ansprechbar ist, kann über die Modellübersicht eingesehen werden. Die Model Cards geben außerdem Auskunft darüber, welche Modelle als Embedding-Endpunkt zur Verfügung stehen.

Bitte beachten Sie: Der model-Parameter in API-Anfragen erwartet den Anzeigenamen des Modells, wie er in der Modellübersicht aufgeführt ist (z. B. OpenAI GPT OSS 120B) – nicht einen technischen Kurznamen oder Slug. Eine abweichende Schreibweise führt zu Fehlern.