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 o AI-Corporate. O AI-Corporate verifica a chave, o orçamento, o período de validade e os modelos permitidos.

Depois o AI-Corporate processa a solicitação através da integração técnica do ambiente.

Do que você precisa?​

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

DadoOnde encontrar
Chave de APIVocê a recebe de um administrador
Endpointhttps://europe-west1-ai-corporate.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 aic.. Trate essa chave como uma senha.

Qual ferramenta escolher?​

AI-Corporate recomenda OpenCode para a maioria dos usuários. OpenCode é uma ferramenta de codificação assistida para terminal, desktop e IDE. A ferramenta pode realizar passos 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 dentro de ambientes Corporativos.

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

Manuseio seguro de chaves​

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

Use preferencialmente:

  • variáveis de ambiente
  • um arquivo .env local que não seja 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 então:

  • se o Coderen está ativado para o ambiente
  • se a 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

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

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

Se aparecer Authorization header with Bearer token is required, isso significa que a ferramenta não está enviando a chave como Authorization: Bearer .... Se aparecer Unknown parameter, remova configurações específicas do provedor que o endpoint Coderen da AI-Corporate não suporta.