Ir para o conteúdo principal

Codificando com chaves de API

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

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

O que você precisa?​

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

DadoOnde você encontra isto?
Chave de APIVocê a recebe de um administrador
Endpointhttps://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nome do modeloPor exemplo gpt-5.4-mini, gpt-5.4 ou gpt-5.5

A chave de API começa com aip.. Trate esta chave como uma senha.

Qual ferramenta escolher?​

AI-Public recomenda OpenCode para a maioria dos usuários. OpenCode é uma ferramenta de codificação orientada por agentes para terminal, desktop e IDE. A ferramenta pode executar etapas de forma independente, editar arquivos e desenvolver tarefas.

Aider é tecnicamente compatível com um endpoint compatível com OpenAI, mas não é recomendado como ferramenta padrão em ambientes Public.

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

Segurança no manejo de chaves​

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

Preferencialmente use:

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

Nunca coloque chaves de API em um repositório público, chat, 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

Peça a um administrador para verificar a chave, em caso de dúvida.

Variáveis de ambiente e OpenCode​

Para o OpenCode, você pode armazenar a chave de API Coderen em um arquivo local .env na pasta do projeto:

AI_SCHOOL_CODEREN_API_KEY=ais.sua-chave-de-api

Certifique-se de que o OpenCode realmente carregue essa variável de ambiente. No PowerShell, você também pode definir temporariamente a variável para o terminal atual:

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

Se você vir Authorization header with Bearer token is required, a ferramenta não enviará a chave como Authorization: Bearer .... Se vir Unknown parameter, remova configurações específicas do provedor que o endpoint Coderen da AI-Public não suporta.