Codificar com chaves de API

Com uma chave de API Coderen, você pode usar ferramentas de programação que funcionam com uma API compatível com OpenAI. A ferramenta envia solicitações para a AI-School. A AI-School verifica a chave, o orçamento, o período de validade e os modelos permitidos.

Em seguida, a AI-School processa a solicitação através da integração técnica do ambiente.

O que você precisa?

Você precisa de três informações:

Dado	Onde encontrar
Chave de API	Você recebe de um administrador ou professor
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nome do modelo	Por exemplo, gpt-5.4-mini, gpt-5.4 ou gpt-5.5

A chave de API começa com ais.. Trate essa chave como uma senha.

Qual modelo escolher?

Para a maioria dos alunos, o GPT-5.4 mini é o melhor ponto de partida. Este modelo é mais barato e adequado para ajuda de programação durante a aula.

Para docentes ou alunos avançados, o GPT-5.4 ou GPT-5.5 pode ser mais adequado, por exemplo em projetos maiores ou código mais complexo.

Qual ferramenta escolher?

A AI-School recomenda duas ferramentas:

Ferramenta	Recomendado para	Por quê
Aider	Alunos codando em sala de aula	Funciona de forma explícita, clara e menos autocentrada
OpenCode	Docentes e usuários avançados	CLI agentic com aplicativo de desktop também disponível

Aider para alunos

Aider funciona como uma ferramenta de pair programming no terminal. O usuário pede ajuda, vê as mudanças e permanece relativamente próximo do código. Isso se encaixa bem na aprendizagem de programação: o aluno recebe suporte, mas continua envolvido no que está acontecendo.

Veja também a documentação oficial do Aider.

OpenCode para uso avançado

OpenCode é mais agentic. A ferramenta pode executar etapas de forma autônoma, editar arquivos e desenvolver tarefas. Isso é poderoso, mas requer mais compreensão de código, git e ambientes de desenvolvimento locais.

Veja também a documentação oficial do OpenCode.

Segurança ao lidar com chaves

Não compartilhe sua chave de API publicamente e não a inclua no código que você compartilha.

Preferir usar:

• variáveis de ambiente
• um arquivo local .env que não é enviado ao git
• a configuração integrada da ferramenta

Para o OpenCode, você pode usar, por exemplo, um .env na pasta do projeto:

AI_SCHOOL_CODEREN_API_KEY=ais.sua-chave-api

Garanta que a ferramenta carregue realmente esse .env. No PowerShell, você também pode definir temporariamente a variável para o terminal atual:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.sua-chave-api"

Atenção

Nunca coloque chaves de API em um repositório público, chat do Teams, documento compartilhado ou captura de tela.

Se a chave não funcionar

Verifique então:

• se Coderen está ativado para o ambiente
• se sua chave ainda está ativa
• se o orçamento não acabou
• se a chave está dentro do período de validade definido
• se você está usando um modelo permitido
• se o endpoint está configurado corretamente
• se a ferramenta envia a chave API como Authorization: Bearer ...
• se a ferramenta não envia parâmetros específicos do provedor que o Coderen da AI-School não suporta

Em caso de dúvida, peça a um administrador ou professor para verificar a chave.