Шифрування за допомогою API-ключів
За допомогою API-ключа Coderen ви можете використати інструменти програмування, що працюють з OpenAI-сумісним API. Інструмент надсилає запити до AI-School. AI-School перевіряє ключ, бюджет, термін дії та дозволені моделі.
Після цього AI-School обробляє запит через технічне з’єднання у середовищі.
Що вам потрібно?
Потрібно три дані:
| Дані | Де їх знайти? |
|---|---|
| API-ключ | Отримуєте від адміністраторa або викладача |
| Endpoint | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| Назва моделі | Наприклад, gpt-5.4-mini, gpt-5.4 або gpt-5.5 |
API-ключ починається з ais.. Обробляйте цей ключ як пароль.
Яку модель обрати?
Для більшості учнів найкращим стартом є GPT-5.4 mini. Ця модель дешевша та підходить для допомоги з програмування під час уроку.
Для викладачів або бі льш просунутих учнів підійдуть GPT-5.4 або GPT-5.5—наприклад, для великих проєктів або більш складного коду.
Який інструмент вибрати?
AI-School рекомендує два інструменти:
| Інструмент | Рекомендовано для | Чому |
|---|---|---|
| Aider | Учні та колективне кодування | Работает прямо, зрозуміло, менше агентного впливу |
| OpenCode | Викладачі та просунуті користувачі | Інструмент CLI з агентним підходом, існує також настільна версія |
Aider для учнів
Aider працює як інструмент парного програмування у терміналі. Користувач просить допомоги, бачить зміни та лишається близьким до код у. Це добре підходить для навчання програмуванню: учень отримує підтримку, але залишається залученим до того, що відбувається.
Дивіться також офіційну документацію Aider: Aider-документація.
OpenCode для просунутого використання
OpenCode більш агентний. Інструмент може самостійно виконувати кроки, редагувати файли та розробляти завдання далі. Це потужно, але потребує більшого розуміння коду, git та локальних середовищ розробки.
Дивіться також офіційну документацію OpenCode: OpenCode-документація.
Безпечне використання ключів
Не публікуйте ваш API-ключ та не вставляйте його в код, який ви ділите.
Надавайте перевагу:
- змінні середовища
- локальний
.env, який не додається до git - вбудована конфігурація інструменту
Наприклад, для OpenCode можна використати .env у папці проєкту:
AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel
Переконайтеся, що інструмент дійсно завантажує цей .env. У PowerShell ви також можете тимчасово встановити змінну для поточної термінальної сесії:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"
Ніколи не розміщуйте API-ключі в публічному репозиторії, у Teams-чату, спільному документі або скріншоті.
Якщо ключ не працює
Перевірте:
- чи Coderen увімкнено для середовища
- чи ваш ключ дійсний
- чи бюджет не вичерпано
- чи ключ укладається у встановлений термін дії
- чи ви використовуєте дозволену модель
- чи правильно встановлено endpoint
- чи інструмент надсилає API-ключ як
Authorization: Bearer ... - чи інструмент не надсилає параметрів, що специфічні для постачальника, які AI-School Coderen не підтримує
За сумнівом звертайтеся до адміністратора або викладача для перевірки ключа.