Ir para o conteúdo principal

Codificar com chave de API

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

Em seguida, AI-Corporate processa a solicitação via a integração técnica do ambiente.

Do que você precisa?​

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

InformaçãoOnde encontrá-la
Chave APIVocê recebe de um administrador
Endpointhttps://europe-west1-ai-corporate.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 aic.. Trate-a como uma senha.

Qual ferramenta escolher?​

AI-Corporate recomenda OpenCode para a maioria dos usuários. OpenCode é uma ferramenta de codificação agentic para terminal, desktop e IDE. A ferramenta pode executar etapas de forma autônoma, 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 corporativos.

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

Segurança no uso de 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 .envlocal 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:

  • 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 tiver dúvidas, peça a um administrador para verificar a chave.

Variáveis de ambiente e OpenCode​

Para o OpenCode, você pode salvar a chave API Coderen em um arquivo local .env no diretório do projeto:

AI_SCHOOL_CODEREN_API_KEY=ais.sua-chave-api

Certifique-se de que o OpenCode realmente carrega essa variável de ambiente. 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"

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

WhatsApp