Provedores Suportados
- OpenAI
- Google Gemini
- Anthropic Claude
- Novita AI
- OpenRouter
- Google Vertex AI
- Amazon Bedrock
- Azure OpenAI
- OpenAI-compatible
- Anthropic-compatible
Ideal para: Modelos GPT mais recentes e desempenho confiável.Obtenha uma chave de API:
- Acesse OpenAI API Keys
- Crie uma nova chave para a Kodus
- Adicione as informações de cobrança
- Inclua a versão da API, como em
https://your-gateway.example.com/v1. A Kodus chama<Base URL>/responsese lista os modelos em<Base URL>/models. - Se o gateway só serve chat completions, conecte-o como OpenAI-compatible.
- A URL deve usar
https://e resolver para um endereço público, porque a Kodus envia sua chave para lá. Gateways na rede privada de uma instalação self-hosted não são suportados. - As requisições saem com
store: false, então nem o gateway nem a OpenAI são solicitados a guardá-las. - Use os IDs de modelo da própria OpenAI (por exemplo
gpt-5.4). Um modelo que o gateway renomeia não é reconhecido como um modelo de reasoning, então o nível de reasoning dele não é enviado. - Não suportado aqui: gateways que precisam de headers próprios além da chave (Portkey, Cloudflare AI Gateway) e o Azure OpenAI, que tem seu próprio provedor Azure OpenAI.
Conectando Kimi (Moonshot) e GLM (Z.ai)
A Moonshot e a Z.ai oferecem, cada uma, um plano de assinatura em um endpoint diferente do da sua Developer API pay-per-token. Cada plano é uma conta separada, com a própria chave — escolha a base URL que corresponde à chave que você tem. O card Moonshot usa o endpoint da Developer API compatível com Anthropic (https://api.moonshot.ai/anthropic). O card Z.ai usa https://api.z.ai/api/anthropic, que a Z.AI documenta para o GLM Coding Plan. Para usar a Developer API da Z.AI, escolha OpenAI-compatible em Custom e informe https://api.z.ai/api/paas/v4/. Para uma chave do Kimi Code Plan, escolha um provedor compatível em Custom e use a base URL da tabela.
- Kimi (Moonshot AI)
- GLM (Z.ai)
No Kimi Code Plan, comece com um limite baixo e ajuste de acordo com sua conta. Veja Ajustar a simultaneidade. O Kimi K2.7 Code sempre usa reasoning. A Kodus oculta o campo de temperatura e omite o parâmetro nas requisições. Veja Temperature.
Fixando provedores do OpenRouter
O OpenRouter é um roteador — quando você pede um modelo (ex.:moonshotai/kimi-k2), ele encaminha a chamada para um de vários provedores upstream (Moonshot direto, Together, Groq, Fireworks, Novita…). Cada chamada pode cair em um backend diferente. Isso é conveniente, mas introduz variação silenciosa:
- Deriva de qualidade — os upstreams rodam com precisões diferentes (FP8, INT4, completa) e dão saídas sutilmente diferentes para prompts idênticos
- Inconsistência de tool calling — alguns backends não suportam function calling do mesmo jeito, levando a tool use malformado
- Variação no formato de reasoning — um upstream respeita
reasoning_effort, outro sóthinking.enabled, outro ignora os dois - Oscilações de latência — o p50 pode pular de 800ms para 4s entre chamadas conforme o roteamento muda
- Surpresas de rate limit — você atinge a cota em um backend que não escolheu explicitamente
Como fixar
Quando o seu provedor BYOK é o OpenRouter, o painel Advanced settings mostra uma seção OpenRouter routing com dois campos:- Pin providers (in order) — lista separada por vírgulas de nomes de upstream (ex.:
moonshot, together). O OpenRouter tenta na ordem e usa o primeiro disponível. - Allow fallbacks — quando desligado, as requisições falham de vez se nenhum dos provedores fixados estiver disponível. Quando ligado (padrão), o OpenRouter pode recorrer a qualquer outro upstream que sirva o modelo.
Avançado: override em JSON bruto
Se você precisa de campos além deorder e allow_fallbacks (ex.: ignore, data_collection, require_parameters), mude Thinking / Reasoning para Custom em Advanced settings (Custom JSON override) e cole o payload de roteamento completo — ele é mesclado em providerOptions junto com qualquer configuração de reasoning: