Перейти к основному содержимому

Кодирование с использованием API-ключей

С помощью API-ключа Coderen вы можете использовать инструменты программирования, взаимодействующие с API совместимо с OpenAI. Инструмент отправляет запросы в AI-School. AI-School проверяет ключ, бюджет, срок действия и разрешенные модели.

Затем AI-School обрабатывает запрос через техническое соединение окружения.

Что нужно?​

Вам понадобятся три данных:

ДанныеГде их найти?
API-ключЕго выдается администратором или преподавателем
Endpointhttps://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Название моделиНапример gpt-5.6-luna, gpt-5.6-terra или gpt-5.6-sol

API-ключ начинается с ais.. Обращайтесь с этим ключом как с паролем.

Какую модель выбрать?​

Для большинства учеников хорошим стартом является GPT-5.6 Luna. Эта быстрая модель подходит для помощи с программированием во время занятия и для обычных вопросов по коду.

Для преподавателей или продвинутых учеников хорошо подходит GPT-5.6 Terra для больших проектов и более сложного кода. Выбирайте GPT-5.6 Sol для самых требовательных задач, требующих анализа, планирования или рассуждений.

Какую инструмент выбрать?​

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.ваш_api_ключ

Убедитесь, что инструмент действительно загружает этот .env. В PowerShell переменную можно временно установить для текущей терминальной сессии:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.ваш_api_ключ"
Внимание

Никогда не размещайте API-ключи в открытом репозитории, чатах Teams, общедоступных документах или скриншотах.

Что делать, если ключ не работает​

Проверьте:

  • включен ли Coderen для окружения
  • активен ли ключ
  • хватает ли бюджета
  • попадает ли ключ в установленный срок действия
  • используете ли вы разрешенную модель
  • правильно ли настроен endpoint
  • отправляет ли инструмент API-ключ в виде Authorization: Bearer ...
  • не отправляет ли инструмент параметры, специфичные для провайдера, которые не поддерживает AI-School Coderen

При сомнениях обратитесь к администратору или преподавателю для проверки ключа.

WhatsApp