Kodowanie z kluczem API

Z kluczem API Koderen możesz korzystać z narzędzi programistycznych działających na API zgodnym z OpenAI. Narzędzie wysyła żądania do AI-School. AI-School weryfikuje klucz, budżet, okres ważności oraz dozwolone modele.

Następnie AI-School przetwarza żądanie poprzez techniczne połączenie środowiska.

Czego potrzebujesz?

Potrzebujesz trzech danych:

Dane	Gdzie to znaleźć?
Klucz API	Otrzymasz go od administratora lub nauczyciela
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nazwa modelu	Na przykład gpt-5.6-luna, gpt-5.6-terra lub gpt-5.6-sol

Klucz API zaczyna się od ais.. Traktuj ten klucz jak hasło.

Jaki model wybrać?

Dla większości uczniów dobrym startem jest GPT-5.6 Luna. Ten szybki model nadaje się do pomocy w programowaniu podczas zajęć i do codziennych pytań o kod.

Dla nauczycieli lub zaawansowanych uczniów dobrze pasuje GPT-5.6 Terra do większych projektów i bardziej złożonego kodu. Wybierz GPT-5.6 Sol do najbardziej wymagających zadań z dużą analizą, planowaniem lub rozumowaniem.

Jakie narzędzie wybrać?

AI-School proponuje dwa narzędzia:

Narzędzie	Przeznaczenie	Dlaczego
Aider	Uczniowie i nauka programowania w klasie	Działa explicite, przejrzyste i mniej agentowe
OpenCode	Nauczyciele i zaawansowani użytkownicy	CLI narzędzie agentowe, dostępna także aplikacja desktopowa

Aider dla uczniów

Aider działa jako narzędzie pair-programming w terminalu. Użytkownik prosi o pomoc, widzi zmiany i pozostaje stosunkowo blisko kodu. Dobrze pasuje do nauki programowania: uczeń otrzymuje wsparcie, ale pozostaje zaangażowany w to, co się dzieje.

Zobacz także oficjalną dokumentację Aider.

OpenCode do zaawansowanego użytkowania

OpenCode jest bardziej agentowy. Narzędzie może samodzielnie wykonywać kroki, edytować pliki i kontynuować zadania. To potężne, ale wymaga większego zrozumienia kodu, git oraz lokalnych środowisk developerskich.

Zobacz także oficjalną dokumentację OpenCode.

Bezpieczne obchodzenie się z kluczami

Nie udostępniaj swojego klucza API publicznie i nie umieszczaj go w kodzie, który udostępniasz.

Najlepiej używaj:

• zmiennych środowiskowych
• lokalnego .env, który nie jest wysyłany do git
• wbudowanej konfiguracji narzędzia

Dla OpenCode możesz na przykład użyć .env w katalogu projektu:

AI_SCHOOL_CODEREN_API_KEY=ais.twoj-klucz-api

Upewnij się, że narzędzie ładuje ten plik .env. W PowerShell możesz tymczasowo ustawić zmienną dla bieżącej sesji terminala:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.twoj-klucz-api"

Uwaga

Nigdy nie umieszczaj kluczy API w publicznym repozytorium, w Teamsie, w udostępnionych dokumentach ani w zrzutach ekranu.

Co zrobić, jeśli klucz nie działa

Sprawdź:

• czy Koderen jest włączony dla środowiska
• czy klucz jest jeszcze aktywny
• czy budżet nie został wyczerpany
• czy klucz mieści się w ustawionym okresie ważności
• czy używasz dozwolonego modelu
• czy endpoint jest poprawnie ustawiony
• czy narzędzie wysyła klucz API jako Authorization: Bearer ...
• czy narzędzie nie wysyła parametrów specyficznych dla dostawcy, których AI-School Koderen nie obsługuje

W razie wątpliwości poproś administratora lub nauczyciela o sprawdzenie klucza.