Ga naar hoofdinhoud

API-sleutels beheren

Op de Coderen-pagina beheer je API-sleutels voor medewerkers en leerlingen. Een API-sleutel geeft toegang tot de OpenAI-compatible Coderen endpoint van AI-School.

Gebruikers gebruiken deze sleutel in een externe programmeertool, zoals Aider of OpenCode.

Medewerkers en leerlingen​

De Coderen-pagina heeft aparte tabbladen voor:

  • Medewerkers
  • Leerlingen

Bij leerlingen worden gebruikers gegroepeerd per groep. Bij medewerkers toont AI-School de medewerkers binnen de toegestane schoolscope.

Een gebruiker moet een gekoppeld account hebben voordat er een sleutel kan worden gemaakt.

Een sleutel maken​

  1. Zoek de medewerker of leerling.
  2. Klik op het sleutel-icoon.
  3. Kies het budget.
  4. Kies eventueel automatisch vernieuwen.
  5. Stel eventueel een geldigheidsperiode in.
  6. Klik op Opslaan.

De API-sleutel wordt één keer getoond. Kopieer de sleutel direct en geef deze veilig aan de gebruiker.

Sleutel maar één keer zichtbaar

Na het sluiten van het venster kan AI-School de volledige API-sleutel niet opnieuw tonen. Is de sleutel kwijt, trek de oude sleutel dan in en maak een nieuwe.

Budget instellen​

Elke sleutel heeft een budget in Amerikaanse dollars. Dit sluit aan op de manier waarop modelkosten worden berekend.

Je kunt:

  • een budget per sleutel instellen
  • automatisch vernieuwen na verbruik aanzetten
  • de sleutel intrekken wanneer deze niet meer nodig is

In de lijst zie je per gebruiker hoeveel budget is verbruikt.

Geldigheidsperiode instellen​

Je kunt een sleutel beperken met een begindatum en einddatum.

Dit is handig voor lessen of tijdelijke projecten. Bijvoorbeeld:

  • start: vandaag om 10:00
  • einde: vandaag om 11:00

De sleutel werkt dan alleen binnen dat tijdvenster. Buiten het tijdvenster wordt de sleutel geweigerd.

Sleutels maken voor een groep​

Bij leerlingen kun je sleutels in één keer maken voor een hele groep.

  1. Open de juiste groep.
  2. Klik op Sleutels maken.
  3. Kies budget, automatisch vernieuwen en eventueel een geldigheidsperiode.
  4. Bevestig het maken van de sleutels.

Na het maken opent automatisch een document met de aangemaakte sleutels. Download of bewaar dit document direct, omdat de volledige sleutels later niet opnieuw zichtbaar zijn.

Sleutels intrekken​

Een sleutel intrekken betekent dat de gebruiker deze sleutel niet meer kan gebruiken.

Je kunt:

  • één sleutel intrekken bij een gebruiker
  • sleutels collectief intrekken voor een groep

AI-School vraagt eerst om bevestiging voordat sleutels worden ingetrokken.

Rapportage en controle​

Gebruik via Coderen wordt gelogd. Hierdoor kunnen beheerders zien:

  • wie de sleutel gebruikt
  • hoeveel verzoeken zijn gedaan
  • hoeveel kosten zijn gemaakt
  • welke chats via de sleutel zijn ontstaan

Deze gegevens helpen om programmeerlessen en projecten beheersbaar te houden.