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

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

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

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

Что вам нужно?​

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

ДанныеГде найти?
API-ключЕго вы получили от администратора или преподавателя
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.ваш-ключ

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

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

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

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

Проверьте:

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

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