Aller au contenu principal

Gérer les API keys

Sur la page Codage, tu gères les API keys pour les collaborateurs et les élèves. Une API key donne accès à l'endpoint Codage compatible OpenAI d'AI-School.

Les utilisateurs emploient cette clé dans un outil de programmation externe, comme Aider ou OpenCode.

Collaborateurs et élèves​

La page Codage contient des onglets séparés pour :

  • Collaborateurs
  • Élèves

Pour les élèves, les utilisateurs sont groupés par groupe. Pour les collaborateurs, AI-School affiche les collaborateurs dans le périmètre d'école autorisé.

Un utilisateur doit avoir un compte lié avant qu'une clé puisse être créée.

Créer une clé​

  1. Recherche le collaborateur ou l'élève.
  2. Clique sur l'icône de clé.
  3. Choisis le budget.
  4. Active éventuellement le renouvellement automatique.
  5. Définis éventuellement une période de validité.
  6. Clique sur Enregistrer.

L'API key n'est affichée qu'une seule fois. Copie la clé immédiatement et transmets-la de manière sécurisée à l'utilisateur.

Clé visible une seule fois

Après la fermeture de la fenêtre, AI-School ne peut plus afficher l'API key complète. Si la clé est perdue, révoque l'ancienne clé et crée-en une nouvelle.

Définir le budget​

Chaque clé dispose d'un budget en dollars américains. Cela correspond à la manière dont les coûts des modèles sont calculés.

Tu peux :

  • définir un budget par clé
  • activer le renouvellement automatique après consommation
  • révoquer la clé lorsqu'elle n'est plus nécessaire

Dans la liste, tu vois pour chaque utilisateur quelle part du budget a été consommée.

Définir une période de validité​

Tu peux limiter une clé avec une date de début et une date de fin.

C'est utile pour des cours ou des projets temporaires. Par exemple :

  • début : aujourd'hui à 10:00
  • fin : aujourd'hui à 11:00

La clé fonctionne alors uniquement dans cette fenêtre de temps. En dehors de cette période, la clé est refusée.

Créer des clés pour un groupe​

Pour les élèves, tu peux créer des clés pour tout un groupe en une seule fois.

  1. Ouvre le bon groupe.
  2. Clique sur Créer des clés.
  3. Choisis le budget, le renouvellement automatique et éventuellement une période de validité.
  4. Confirme la création des clés.

Après la création, un document contenant les clés créées s'ouvre automatiquement. Télécharge ou conserve ce document immédiatement, car les clés complètes ne seront plus visibles plus tard.

Révoquer des clés​

Révoquer une clé signifie que l'utilisateur ne peut plus utiliser cette clé.

Tu peux :

  • révoquer une clé individuelle chez un utilisateur
  • révoquer collectivement les clés d'un groupe

AI-School demande d'abord une confirmation avant de révoquer des clés.

Rapports et contrôle​

L'utilisation via Codage est journalisée. Les administrateurs peuvent ainsi voir :

  • qui utilise la clé
  • combien de requêtes ont été effectuées
  • quels coûts ont été générés
  • quels chats ont été créés via la clé

Ces données aident à garder les cours de programmation et les projets maîtrisables.