Ir para o conteúdo principal

Codificando com chave 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 integração técnica do ambiente.

O que você precisa?​

Você precisa de três dados:

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

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

Qual ferramenta escolher?​

AI-Public recomenda OpenCode para a maioria dos usuários. OpenCode é uma ferramenta de codificação com foco em 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.

Como lidar com chaves com segurança​

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

É recomendado usar:

  • variáveis de ambiente
  • um arquivo local .env que não é enviado ao git
  • a configuração embutida 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 definido
  • se você está usando um modelo permitido
  • se o endpoint está configurado corretamente

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

Variáveis de ambiente e OpenCode​

Para o OpenCode, você pode armazenar a chave da API Coderen em um arquivo .env local no diretório 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, isso significa que a ferramenta não está enviando a chave como Authorization: Bearer .... Se vir Unknown parameter, remova as configurações específicas do provider que o endpoint Coderen da AI-Public não suporta.

WhatsApp