Kodowanie z kluczami API
Z kluczem API Kodowania możesz korzystać z narzędzi programistycznych działających z API zgodnym z OpenAI. Narzędzie wysyła żądania do AI-School. AI-School weryfikuje klucz, budżet, okres ważności i dozwolone modele.
Następnie AI-School przetwarza żądanie przez techniczne połączenie środowiska.
Czego potrzebujesz?
Potrzebujesz trzech informacji:
| Informacja | 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.4-mini, gpt-5.4 lub gpt-5.5 |
Klucz API zaczyna się od ais.. Traktuj ten klucz jak hasło.
Jaki model wybrać?
Dla większości uczniów najlepszym początkiem jest GPT-5.4 mini. Model ten jest tańszy i odpowiedni do pomocy w programowaniu podczas zajęć.
Dla nauczycieli lub zaawansowanych uczniów mogą lepiej pasować GPT-5.4 lub GPT-5.5, na przykład przy większych projektach lub bardziej skomplikowanym kodzie.
Które narzędzie wybrać?
AI-School poleca dwa narzędzia:
| Narzędzie | Przeznaczenie | Dlaczego |
|---|---|---|
| Aider | Uczniowie i wspólne kodowanie w klasie | Działa jawnie, przejrzyście i mniej agentycznie |
| OpenCode | Nauczyciele i zaawansowani użytkownicy | CLI-agent z aplikacją desktopową w zestawie |
Aider dla uczniów
Aider działa jako narzędzie do pair-programming w terminalu. Użytkownik prosi o pomoc, widzi zmiany i pozostaje blisko kodu. Pasuje to do nauki programowania: uczniowi udzielana jest pomoc, ale sam jest zaangażowany w to, co się dzieje.
Zobacz także oficjalną dokumentację Aider.
OpenCode do zaawansowanego użytku
OpenCode jest bardziej agentowy. Narzędzie może samodzielnie wykonywać kroki, edytować pliki i rozwijać zadania. To potężne, ale wymaga także większego zrozumienia kodu, gita i lokalnych środowisk developerskich.
Zobacz także oficjalną dokumentację OpenCode.
Bezpieczne obchodzenie się z kluczami
Nie udostępniaj publicznie swojego klucza API i nie umieszczaj go w kodzie, który udostępniasz.
Najlepiej używaj:
- zmiennych środowiskowych
- lokalnego pliku
.env, który nie jest wysyłany do git - wbudowanej konfiguracji narzędzia
Dla OpenCode możesz na przykład użyć pliku .env w katalogu projektu:
AI_SCHOOL_CODEREN_API_KEY=ais.twój-klucz-api
Upewnij się, że narzędzie faktycznie ładuje ten .env. W PowerShell zmienną możesz tymczasowo ustawić dla bieżącego terminala:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.twój-klucz-api"
Nigdy nie umieszczaj kluczy API w publicznym repozytorium, w Teamsie, w udostępnionym dokumencie ani w zrzucie ekranu.
Jeśli klucz nie działa
Sprawdź wtedy:
- czy Kodowanie jest włączone dla środowiska
- czy Twój klucz jest nadal aktywny
- czy budżet nie wygasł
- czy klucz mieści się w ustalonym okresie ważności
- czy używasz dozwolonego modelu
- czy endpoint jest prawidłowo skonfigurowany
- czy narzędzie przesyła klucz API jako
Authorization: Bearer ... - czy narzędzie nie wysyła parametrów specyficznych dla dostawcy, które AI-School Kodowanie nie obsługuje
W razie wątpliwości zapytaj administratora lub nauczyciela, by sprawdzić klucz.