Solução de problemas
'Invalid API key' ao clicar em Test
'Invalid API key' ao clicar em Test
- Copie a chave sem espaços extras, aspas ou quebras de linha no final.
- Confirme que a cobrança está habilitada e que a conta tem créditos.
- Para chaves do GLM Coding Plan / Kimi Code Plan, certifique-se de que a base URL corresponde ao plano — chaves de assinatura não funcionam no endpoint da Developer API e vice-versa.
'Model not found' ao clicar em Test
'Model not found' ao clicar em Test
- O Test envia uma requisição real ao modelo, então um Model ID errado ou com erro de grafia falha aqui. Isso é esperado e melhor do que falhar na hora da revisão.
- Copie o Model ID exato do painel do provedor. Alguns provedores usam caminhos profundos (ex.: Fireworks
accounts/fireworks/models/kimi-k2p7-code) ou escrevem versões de forma diferente (k2p7vsk2.7).
'Endpoint not found' ao clicar em Test
'Endpoint not found' ao clicar em Test
- Verifique se a base URL corresponde exatamente ao provedor (a barra final importa em alguns).
- Para provedores compatíveis com OpenAI, o endpoint geralmente é
{baseURL}/chat/completions(a Kodus adiciona o caminho), então cole a base URL sem ele. Uma URL que termina em/chat/completions,/messagesou/responsesé rejeitada, e a mensagem informa o endereço a usar no lugar. - Um
404em uma URL OpenAI ou OpenAI-compatible sem versão geralmente significa que ela precisa de/v1. A mensagem sugere a URL corrigida. - A URL deve usar
https://e resolver para um endereço público. Uma URL que resolve para um endereço privado ou reservado é rejeitada.
O Test rejeita a temperature ou o reasoning que defini
O Test rejeita a temperature ou o reasoning que defini
- Alguns modelos fixam a temperature ou sempre fazem reasoning (Kimi
k2p7-code/k3, GLM-5.3; Claude 4.7+/GPT-5 removem a temperature por completo). O Test valida seu ajuste contra as regras do modelo e retorna uma mensagem específica — siga-a (deixe a temperature sem definir ou use o valor exigido; não coloque o reasoning em Off em um modelo que sempre faz reasoning). Veja Temperature.
'Rate limited' ou 'Too much concurrency'
'Rate limited' ou 'Too much concurrency'
- Diminua Max concurrent requests em Advanced settings.
- Se a Z.AI aprovar o uso do GLM Coding Plan, confirme com ela o limite do seu plano. Veja Ajustar a simultaneidade.
- No Kimi Code Plan, reduza o limite se o erro indicar excesso de requisições simultâneas. Veja Ajustar a simultaneidade.
Variáveis de ambiente self-hosted não aparecem
Variáveis de ambiente self-hosted não aparecem
- Se a Kodus está configurada por variáveis de ambiente, a página AI providers mostra Kodus is currently using an LLM configured via environment variables com o modelo e o provedor (e se o provedor foi definido em
API_LLM_PROVIDERou deduzido), enquanto nenhum modelo estiver conectado ali. A chave nunca é exibida. - Conectar um modelo e salvar substitui a configuração do ambiente.
Custos altos ou inesperados
Custos altos ou inesperados
- O reasoning adiciona tokens. Se o custo está disparando, diminua Thinking / Reasoning de Medium para Low, ou roteie tarefas mais leves para um modelo mais barato em Other task models em Code review → Routing.
- Veja Uso de tokens para saber o custo de cada modelo, PR, revisão e desenvolvedor, confira o painel do seu provedor para o detalhamento por modelo e defina um orçamento mensal com alertas de gasto na aba Budget (apenas alertas; defina um limite rígido no seu provedor).
Perguntas Frequentes
Posso trocar de provedor a qualquer momento?
Posso trocar de provedor a qualquer momento?
O que acontece se minha chave de API ficar sem créditos?
O que acontece se minha chave de API ficar sem créditos?
Como funciona o sistema de padrão / fallback?
Como funciona o sistema de padrão / fallback?
Tarefas diferentes podem usar modelos diferentes?
Tarefas diferentes podem usar modelos diferentes?
Vocês armazenam nossas chaves de API com segurança?
Vocês armazenam nossas chaves de API com segurança?
Posso usar um LLM self-hosted (ex.: Ollama, vLLM)?
Posso usar um LLM self-hosted (ex.: Ollama, vLLM)?
https:// que resolva para um endereço público, então localhost e endereços de rede privada são rejeitados. Em uma instância self-hosted da Kodus, defina um endpoint em uma rede privada com variáveis de ambiente; veja Instalação.