Ir para o conteúdo principal

Codificando com chave de API

Com uma chave de Coderen API 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:

DadoOnde encontrar
Chave APIVocê a recebe de um administrador ou professor
Endpointhttps://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nome do modeloPor exemplo gpt-5.6-luna, gpt-5.6-terra ou gpt-5.6-sol

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

Qual modelo escolher?​

Para a maioria dos alunos, GPT-5.6 Luna é um bom começo. Este modelo rápido é adequado para ajuda de programação durante a aula e perguntas de código do dia a dia.

Para docentes ou alunos avançados, GPT-5.6 Terra funciona bem para projetos maiores e código mais complexo. Escolha GPT-5.6 Sol para as tarefas mais exigentes que envolvem muita análise, planejamento ou raciocínio.

Qual ferramenta escolher?​

A AI-School sugere duas ferramentas:

FerramentaRecomendado paraPor quê
AiderAlunos e programação em sala de aulaFunciona de forma explícita, clara e menos autocentrada
OpenCodeProfessores e usuários avançadosCLI com agente e também aplicativo desktop

Aider para alunos​

Aider funciona como uma ferramenta de pair programming no terminal. O usuário solicita ajuda, vê as alterações e permanece relativamente próximo ao código. Isso combina bem com aprender a programar: o aluno recebe suporte, mas continua envolvido no que está acontecendo.

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

OpenCode para uso avançado​

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

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

Segurança ao lidar com chaves​

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

Preferencialmente use:

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

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

AI_SCHOOL_CODEREN_API_KEY=ais.sua-chave-api

Certifique-se de que a ferramenta carregue esse .env. No PowerShell você também pode definir a variável temporariamente para o terminal atual:

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

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

Se a chave não funcionar​

Verifique:

  • 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 configurado
  • 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 AI-School Coderen não suporta

Caso tenha dúvidas, peça a um administrador ou professor para verificar a chave.

WhatsApp