Zum Hauptinhalt springen

API-Schlüssel verwalten

Auf der Coding-Seite verwaltest du API-Schlüssel für Mitarbeiter und Schüler. Ein API-Schlüssel gibt Zugriff auf den OpenAI-kompatiblen Coding-Endpoint von AI-School.

Benutzer verwenden diesen Schlüssel in einem externen Programmiertool, zum Beispiel Aider oder OpenCode.

Mitarbeiter und Schüler​

Die Coding-Seite hat getrennte Tabs für:

  • Mitarbeiter
  • Schüler

Bei Schülern werden Benutzer pro Gruppe gebündelt. Bei Mitarbeitern zeigt AI-School die Mitarbeiter innerhalb des erlaubten Schulbereichs.

Ein Benutzer muss ein verknüpftes Konto haben, bevor ein Schlüssel erstellt werden kann.

Einen Schlüssel erstellen​

  1. Suche den Mitarbeiter oder Schüler.
  2. Klicke auf das Schlüssel-Icon.
  3. Wähle das Budget.
  4. Aktiviere optional die automatische Erneuerung.
  5. Lege optional einen Gültigkeitszeitraum fest.
  6. Klicke auf Speichern.

Der API-Schlüssel wird nur einmal angezeigt. Kopiere den Schlüssel sofort und gib ihn sicher an den Benutzer weiter.

Schlüssel nur einmal sichtbar

Nach dem Schließen des Fensters kann AI-School den vollständigen API-Schlüssel nicht erneut anzeigen. Wenn der Schlüssel verloren geht, widerrufe den alten Schlüssel und erstelle einen neuen.

Budget festlegen​

Jeder Schlüssel hat ein Budget in US-Dollar. Das passt zur Art, wie Modellkosten berechnet werden.

Du kannst:

  • ein Budget pro Schlüssel festlegen
  • automatische Erneuerung nach Verbrauch aktivieren
  • den Schlüssel widerrufen, wenn er nicht mehr benötigt wird

In der Liste siehst du pro Benutzer, wie viel Budget verbraucht wurde.

Gültigkeitszeitraum festlegen​

Du kannst einen Schlüssel mit Startdatum und Enddatum begrenzen.

Das ist praktisch für Unterrichtsstunden oder temporäre Projekte. Zum Beispiel:

  • Start: heute um 10:00 Uhr
  • Ende: heute um 11:00 Uhr

Der Schlüssel funktioniert dann nur innerhalb dieses Zeitfensters. Außerhalb des Zeitfensters wird der Schlüssel abgelehnt.

Schlüssel für eine Gruppe erstellen​

Bei Schülern kannst du Schlüssel auf einmal für eine ganze Gruppe erstellen.

  1. Öffne die richtige Gruppe.
  2. Klicke auf Schlüssel erstellen.
  3. Wähle Budget, automatische Erneuerung und optional einen Gültigkeitszeitraum.
  4. Bestätige das Erstellen der Schlüssel.

Nach dem Erstellen öffnet sich automatisch ein Dokument mit den erstellten Schlüsseln. Lade oder speichere dieses Dokument sofort, weil die vollständigen Schlüssel später nicht erneut sichtbar sind.

Schlüssel widerrufen​

Einen Schlüssel zu widerrufen bedeutet, dass der Benutzer diesen Schlüssel nicht mehr verwenden kann.

Du kannst:

  • einen einzelnen Schlüssel bei einem Benutzer widerrufen
  • Schlüssel gesammelt für eine Gruppe widerrufen

AI-School fragt zuerst um Bestätigung, bevor Schlüssel widerrufen werden.

Berichte und Kontrolle​

Nutzung über Coding wird protokolliert. Dadurch können Administratoren sehen:

  • wer den Schlüssel verwendet
  • wie viele Anfragen gestellt wurden
  • welche Kosten entstanden sind
  • welche Chats über den Schlüssel entstanden sind

Diese Daten helfen dabei, Programmierunterricht und Projekte überschaubar zu halten.