Перейти до основного змісту

Шифрування за допомогою API-ключів

За допомогою API-ключа Coderen ви можете використати інструменти програмування, що працюють з OpenAI-сумісним API. Інструмент надсилає запити до AI-School. AI-School перевіряє ключ, бюджет, термін дії та дозволені моделі.

Після цього AI-School обробляє запит через технічне з’єднання у середовищі.

Що вам потрібно?

Потрібно три дані:

ДаніДе їх знайти?
API-ключОтримуєте від адміністраторa або викладача
Endpointhttps://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 не підтримує

За сумнівом звертайтеся до адміністратора або викладача для перевірки ключа.