Coder avec des API keys

Avec une API key Codage, tu peux utiliser des outils de programmation qui fonctionnent avec une API compatible OpenAI. L'outil envoie les requêtes à AI-School. AI-School vérifie la clé, le budget, la période de validité et les modèles autorisés.

AI-School traite ensuite la demande via le raccordement technique de l'environnement.

De quoi as-tu besoin ?

Tu as besoin de trois informations :

Information	Où la trouver ?
API key	Tu la reçois d'un administrateur ou d'un enseignant
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nom du modèle	Par exemple gpt-5.4-mini, gpt-5.4 ou gpt-5.5

L'API key commence par ais.. Traite cette clé comme un mot de passe.

Quel modèle choisir ?

Pour la plupart des élèves, GPT-5.4 mini est le meilleur point de départ. Ce modèle est moins coûteux et adapté à l'aide à la programmation pendant le cours.

Pour les enseignants ou les élèves avancés, GPT-5.4 ou GPT-5.5 peut mieux convenir, par exemple pour de plus grands projets ou du code plus complexe.

Quel outil choisir ?

AI-School recommande deux outils :

Outil	Recommandé pour	Pourquoi
Aider	Élèves et codage en classe	Fonctionne de manière explicite, claire et moins agentic
OpenCode	Enseignants et utilisateurs avancés	Outil CLI agentic avec aussi une application desktop

Aider pour les élèves

Aider fonctionne comme un outil de pair programming dans le terminal. L'utilisateur demande de l'aide, voit les modifications et reste relativement proche du code. Cela convient bien à l'apprentissage de la programmation : l'élève reçoit de l'aide, mais reste impliqué dans ce qui se passe.

Voir aussi la documentation officielle d'Aider.

OpenCode pour un usage avancé

OpenCode est plus agentic. L'outil peut exécuter des étapes de manière autonome, modifier des fichiers et élaborer des tâches. C'est puissant, mais cela demande aussi plus de compréhension du code, de Git et des environnements de développement locaux.

Voir aussi la documentation officielle d'OpenCode.

Utiliser les clés en sécurité

Ne partage pas ton API key publiquement et ne la place pas dans du code que tu partages.

Utilise de préférence :

• des variables d'environnement
• un fichier .env local qui n'est pas envoyé vers Git
• la configuration intégrée de l'outil

Attention

Ne place jamais d'API keys dans un dépôt public, un chat Teams, un document partagé ou une capture d'écran.

Si la clé ne fonctionne pas

Vérifie :

• si Codage est activé pour l'environnement
• si ta clé est encore active
• si le budget n'est pas épuisé
• si la clé se trouve dans la période de validité définie
• si tu utilises un modèle autorisé
• si l'endpoint est correctement configuré

En cas de doute, demande à un administrateur ou à un enseignant de vérifier la clé.

Variables d'environnement et OpenCode

Pour OpenCode, vous pouvez enregistrer la cl? API de codage dans un fichier .env local dans le dossier du projet :

AI_SCHOOL_CODEREN_API_KEY=ais.votre-cle-api

Assurez-vous qu'OpenCode charge r?ellement cette variable d'environnement. Dans PowerShell, vous pouvez aussi la d?finir temporairement pour le terminal actuel :

$env:AI_SCHOOL_CODEREN_API_KEY="ais.votre-cle-api"

Si vous voyez Authorization header met Bearer token is verplicht, l'outil n'a pas envoy? la cl? sous la forme Authorization: Bearer .... Si vous voyez Unknown parameter, supprimez les param?tres sp?cifiques au fournisseur que l'endpoint de codage de AI-School ne prend pas en charge.