Pular para o conteúdo principal
BYOK (Bring Your Own Key) é a forma padrão como o Kodus usa LLMs em todos os planos — Community, Teams e Enterprise. Você conecta sua própria conta de provedor, escolhe qualquer modelo, paga apenas pelo que usa e monitora custos diretamente no painel do seu provedor. O Kodus nunca cobra margem sobre tokens.

Como isso se aplica aos planos

O BYOK é gratuito no Community, incluído no Teams ($10/dev ativo/mês além do seu gasto com tokens), e uma das duas opções no Enterprise (a outra sendo uma chave de API gerenciada pelo Kodus).

​
Primeiros Passos

1

Acessar as Configurações de BYOK

Navegue até as configurações da sua organização em app.kodus.io/organization/byok
2

Configurar o Modelo Primário

Selecione seu provedor principal (OpenAI, Google Gemini, Anthropic, etc.) e insira sua chave de API com o modelo de sua preferência
3

Configurar o Modelo de Fallback (Recomendado)

Configure um modelo secundário como backup. Se o seu modelo primário apresentar problemas ou ficar indisponível, as revisões mudam automaticamente para o fallback
4

Testar a Configuração

O Kodus validará ambas as chaves de API e seleções de modelo antes de salvar
Importante: Sempre configure um modelo de fallback para garantir revisões de código contínuas, mesmo que seu provedor primário experimente instabilidade ou limites de taxa.
Mantenha suas chaves de API seguras e nunca as compartilhe. Use chaves separadas para o Kodus para melhor rastreamento de uso e custos.

​
Provedores Suportados

Melhor para: Modelos GPT mais recentes e desempenho confiávelComo obter a chave de API:
  1. Acesse OpenAI API Keys
  2. Crie uma nova chave de API para o Kodus
  3. Adicione informações de cobrança à sua conta OpenAI
A OpenAI oferece o serviço mais confiável com excelente variedade de modelos. Comece com o GPT-5-mini para melhor custo-benefício.

​
Modelos Recomendados e Testados

Estes são os modelos que testamos extensivamente e recomendamos para revisão de código com o Kodus:

Gemini 2.5 Pro

Mais Testado e RecomendadoO modelo mais recente do Google com compreensão de código excepcional, janela de contexto de mais de 1M tokens e melhor custo-benefício.
  • Provedor: Google
  • Melhor para: Excelência geral

Gemini 2.5 Flash

Melhor Custo-BenefícioUltra-rápido e econômico sem comprometer a qualidade. Perfeito para equipes de alto volume.
  • Provedor: Google
  • Melhor para: Equipes com orçamento limitado

Claude 4.5 Sonnet

Melhor para CódigoCapacidades de programação excepcionais com 77,2% de desempenho no SWE-Bench. Excelente compreensão de bases de código complexas.
  • Provedor: Anthropic
  • Melhor para: Foco em qualidade de código

Claude 4.1 Opus

Qualidade PremiumModelo de alto nível para as revisões de código mais exigentes e análise arquitetural complexa.
  • Provedor: Anthropic
  • Melhor para: Projetos enterprise

GPT-5

Inovação Mais RecenteO modelo mais novo da OpenAI com capacidades de ponta e preços competitivos.
  • Provedor: OpenAI
  • Melhor para: Funcionalidades mais recentes

GPT-5-mini

Rápido e ConfiávelExcelente equilíbrio entre velocidade, custo e qualidade da OpenAI.
  • Provedor: OpenAI
  • Melhor para: Confiabilidade com orçamento
Nossa recomendação: Comece com o Gemini 2.5 Pro para a melhor experiência geral. É o nosso modelo mais testado e oferece excelente qualidade a um ótimo preço.

​
Boas Práticas

​
Segurança

Chaves Dedicadas

Crie chaves de API separadas especificamente para o Kodus para melhor rastreamento de uso e maior segurança

Rotação Regular

Rotacione suas chaves de API periodicamente e atualize-as nas configurações do Kodus

Monitorar Uso

Verifique regularmente os painéis dos seus provedores em busca de padrões de uso incomuns

Armazenamento Seguro

Nunca compartilhe ou faça commit de chaves de API em repositórios de código

​
Solução de Problemas

Soluções:
  • Verifique se a chave de API foi copiada corretamente, sem espaços extras
  • Confirme que o faturamento está habilitado na sua conta do provedor
  • Garanta que a chave de API tem as permissões necessárias
  • Tente gerar uma nova chave de API se o problema persistir
Soluções:
  • Verifique se o nome do modelo corresponde exatamente ao formato do seu provedor
  • Confirme se o modelo está disponível na sua região
  • Garanta que sua conta tem acesso ao modelo especificado
  • Tente um modelo diferente para verificar se o problema é específico ao modelo
Soluções:
  • Verifique os limites de taxa do seu provedor e faça upgrade se necessário
  • Considere mudar para um provedor com limites de taxa mais altos
  • Entre em contato com o suporte do seu provedor para aumentar os limites
  • Distribua o uso entre múltiplas chaves de API, se permitido
Soluções:
  • Verifique se o formato da URL base inclui o protocolo (https://)
  • Confirme que o endpoint suporta API compatível com OpenAI
  • Teste a URL diretamente com uma ferramenta como curl ou Postman
  • Garanta que não há restrições de firewall bloqueando a conexão
Soluções:
  • Revise seu uso no painel do provedor
  • Verifique se os limites de taxa estão configurados adequadamente
  • Considere mudar para um modelo mais econômico
  • Configure alertas de faturamento para detectar picos antecipadamente

​
Perguntas Frequentes

Sim. As alterações entram em vigor imediatamente para novas revisões.
As revisões mudam automaticamente para o seu modelo de fallback (se configurado). Sem um fallback, as revisões falham até você adicionar créditos. Sempre configure um modelo de fallback.
O primário lida com todas as revisões por padrão. Se ele falhar (limites de taxa, instabilidade, erros), o Kodus muda para o fallback automaticamente. Você paga apenas pelo modelo que processa cada revisão.
Não. Use provedores diferentes (ex.: Google como primário, OpenAI como fallback) para se proteger contra falhas específicas de um provedor.
Sim. As chaves são criptografadas em repouso e em trânsito. Nunca registramos ou armazenamos chaves em texto simples.