Codificare cu chei API

Cu o cheie API Coderen poți utiliza uneluri de programare care funcționează cu o API compatibilă OpenAI. Instrumentul trimite cereri către AI-School. AI-School verifică cheia, bugetul, perioada de valabilitate și modelele permise.

Apoi AI-School procesează cererea prin legătura tehnică a mediului.

Cu ce ai nevoie?

Ai nevoie de trei date:

Date	Unde le găsești?
Cheie API	O primești de la administrator sau profesor
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Numele modelului	De exemplu gpt-5.6-luna, gpt-5.6-terra sau gpt-5.6-soare

Cheia API începe cu ais.. Tratează această cheie ca pe o parolă.

Ce model alegi?

Pentru majoritatea elevilor, GPT-5.6 Luna este un început bun. Acest model rapid este potrivit pentru ajutorul de programare în timpul orelor și pentru întrebări obișnuite despre cod.

Pentru profesori sau elevi avansați, GPT-5.6 Terra se potrivește bine pentru proiecte mai mari și cod mai complex. Alege GPT-5.6 Soare pentru cele mai solicitante sarcini cu multă analiză, planificare sau raționament.

Pe care tool să-l alegi?

AI-School recomandă două unelte:

Unelte	Recomandate pentru	Motiv
Aider	Elevi și programare în clasă	Funcționează explicit, clar și mai puțin agentic
OpenCode	Profesori și utilizatori avansați	CLI agentic cu și o aplicație desktop

Aider pentru elevi

Aider funcționează ca un instrument de programare în pereche în terminal. Utilizatorul cere ajutor, vede modificările și rămâne relativ aproape de cod. Se potrivește bine pentru învățarea programării: elevul primește suport, dar rămâne implicat în ceea ce se întâmplă.

Vezi și documentația oficială Aider.

OpenCode pentru utilizare avansată

OpenCode este mai agentic. Unelta poate efectua pași în mod autonom, poate modifica fișiere și poate dezvolta sarcini în continuare. Este puternic, dar cere și mai mult înțelegere a codului, git și a mediilor de dezvoltare locale.

Vezi și documentația oficială OpenCode.

Găzduirea în siguranță a cheilor

Nu împărtăși cheia API public și nu o pune în codul pe care îl distribui.

Preferabil să folosești:

• variabile de mediu
• un fișier .env local care nu este trimis la git
• configurația încorporată a uneltei

Pentru OpenCode poți, de exemplu, să folosești un .env în dosarul proiectului:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Asigură-te că instrumentul încarcă cu adevărat acest .env. În PowerShell poți seta temporar variabila pentru sesiunea curentă a terminalului:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Atenție

Nu plasa cheile API într-un depozit public, chat Teams, document partajat sau screenshot.

Dacă cheia nu funcționează

Verifică apoi:

• dacă Coderen este activat pentru mediul înconjurător
• dacă cheia este încă activă
• dacă bugetul nu a expirat
• dacă cheia este în intervalul de valabilitate setat
• dacă reprezinți un model permis
• dacă endpoint-ul este configurat corect
• dacă uneltele transmite cheia API ca Authorization: Bearer ...
• dacă unelta nu trimite parametri specifici furnizorului pe care AI-School Coderen nu-i suportă

În caz de îndoială, întreabă un administrator sau profesor pentru verificarea cheii.