Pular para o conteúdo principal
Escolha seu provedor para ver como obter uma chave e o que informar. Adicione o modelo na página AI providers; veja Conectar um provedor.

Provedores Suportados

Ideal para: Modelos GPT mais recentes e desempenho confiável.Obtenha uma chave de API:
  1. Acesse OpenAI API Keys
  2. Crie uma nova chave para a Kodus
  3. Adicione as informações de cobrança
Pelo seu próprio gateway: se o seu tráfego da OpenAI passa por um gateway de protocolo OpenAI que serve a Responses API, defina o endereço dele na Base URL opcional e use a chave que o gateway espera. Com os IDs de modelo da própria OpenAI, as revisões rodam então como em uma chave direta da OpenAI: a Responses API, saída estruturada estrita e o seu nível de reasoning.
  • Inclua a versão da API, como em https://your-gateway.example.com/v1. A Kodus chama <Base URL>/responses e 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.
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.
Para uma configuração estável, fixe um único provedor e desligue os fallbacks (Pin: moonshot, Allow fallbacks: off). As requisições sempre caem no mesmo upstream ou falham de forma explícita — sem mudanças silenciosas de qualidade. A contrapartida é nenhuma resiliência se esse upstream cair; combine com um Fallback model em um provedor diferente (ex.: Anthropic) para absorver indisponibilidades.
Os nomes de upstream devem corresponder ao catálogo do OpenRouter. Confira as tags de provedor em openrouter.ai/docs/features/provider-routing — valores comuns incluem moonshot, together, groq, fireworks, novita.
Por baixo dos panos, a Kodus emite isto na chamada do Vercel AI SDK:

Avançado: override em JSON bruto

Se você precisa de campos além de order 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: