Skip to main content

​
Como o Moonshot funciona

A Moonshot AI publica a família de modelos Kimi (K2, K2.5, K2.6, K2.6 Coding). O Kimi é particularmente forte em compreensão de código de contexto longo e fluxos agênticos, e a API é totalmente compatível com OpenAI — o Kodus pode se comunicar com ela via o provedor OpenAI-compatible. O Kodus também tem um provedor Moonshot dedicado, que se conecta pelo endpoint compatível com Anthropic da Moonshot (https://api.moonshot.ai/anthropic). A Moonshot oferece dois caminhos para a mesma família de modelos, cada um com seu próprio endpoint:
  • Developer API (platform.moonshot.ai) — pay-per-token, cobrado por uso. A simultaneidade escala com seu tier de recarga.
  • Kimi Code Plan (kimi.com/code) — assinatura com um endpoint de codificação dedicado. Preço fixo, simultaneidade limitada (30 simultâneas).
As assinaturas do chat de consumidor Kimi.com da Moonshot (Andante, Moderato, etc.) são separadas de ambos os caminhos de API. Assinaturas de chat não concedem acesso à API. O Kimi Code Plan é a assinatura específica para API.
A Moonshot também opera uma plataforma exclusiva para a China (platform.moonshot.cn, URL base https://api.moonshot.cn/v1) cobrada em CNY. Use apenas se você opera dentro da China continental.

​
Visão geral dos planos

​
Kimi Code Plan (assinatura)

​
Developer API (pay-per-token)

Endpoint da Developer API: https://api.moonshot.ai/v1 (internacional). A simultaneidade escala com o tier de recarga — Tier 1 ($10 de recarga) começa em ~50 simultâneas, até ~1000 simultâneas no Tier 5.

​
Criando uma Chave de API

Uma conta Moonshot é necessária para criar uma chave de API.
  1. Vá para kimi.com/code e assine o plano.
  2. Abra a área de gerenciamento de chaves da sua assinatura.
  3. Crie uma chave do Kimi Code e copie-a.
Chaves do Kimi Code funcionam apenas contra https://api.kimi.com/coding/v1. Elas retornarão 401 se enviadas para api.moonshot.ai.

​
Configurar o Moonshot no Kodus

O fluxo principal é a página AI providers no Kodus Cloud. Usuários self-hosted que preferem fixar o provedor no nível do processo podem usar variáveis de ambiente.

​
Opção 1 — Provedor Moonshot no Kodus Cloud (recomendado para a Developer API)

1

Abrir AI providers e escolher Moonshot

Na barra lateral, abra AI providers (app.kodus.io/byok). Na aba Providers, clique no card Moonshot (em Connect your first provider, ou em Add another provider se você já conectou um).
2

Colar sua chave de API e escolher o modelo

Cole sua chave da Developer API de platform.moonshot.ai no card API key. O seletor Model então carrega os modelos da Moonshot — escolha um (ex.: kimi-k2.6) ou selecione Type model manually. O Kodus preenche o endpoint https://api.moonshot.ai/anthropic para você; este card não tem seletor de plano nem campo de URL base, então para uma chave do Kimi Code Plan (ou da plataforma chinesa) use a Opção 2 abaixo.
3

Test & save

Clique em Test & save. O Kodus testa a conexão e salva a configuração em caso de sucesso. 401 significa que a chave não corresponde ao endpoint.

​
Ajustar reasoning (opcional)

Thinking / Reasoning fica em Advanced (optional). Para o Kimi, qualquer nível diferente de Off emite thinking: { type: "enabled" }. Para sobrescrever, mude Thinking / Reasoning para Custom e cole um destes:
  • Desabilitar thinking para revisões mais rápidas/baratas em PRs pequenos:
  • Forçar um budget de tokens específico (se a Moonshot adicionar suporte a budget_tokens no seu tier):
Não é necessário envolver em namespace — o Kodus envolve as opções sob o namespace do provider ativo antes de enviar. Veja main BYOK doc → Custom JSON override para detalhes.

​
Ajustar simultaneidade

  • Kimi Code Plan: defina Max concurrent requests (em Advanced (optional)) como 30 (o limite documentado). Ir além retorna 429.
  • Developer API: comece vazio (sem limite). Seu limite real escala com seu tier de recarga — Tier 1 (~10derecarga)permite 50simulta^neas;Tier5( 10 de recarga) permite ~50 simultâneas; Tier 5 (~3000) permite ~1000. Reduza explicitamente se você ver 429s no momento da revisão.
Na aba Routing, defina o Kimi como Model for all tasks e um modelo OpenAI ou Anthropic como Fallback (optional) — se a Moonshot retornar 429 ou 402, o Kodus faz failover automaticamente.

​
Opção 2 — Endpoint OpenAI-compatible

Para o Kimi Code Plan, a plataforma chinesa ou o endpoint OpenAI-compatible da Moonshot, abra AI providers, escolha OpenAI-compatible em Custom na aba Providers e preencha:

​
Opção 3 — Self-hosted (variáveis de ambiente)

Se você executa o Kodus em Fixed Mode (provedor global único, sem BYOK por organização), configure a Moonshot no .env dos seus containers de API e worker:
Este caminho só é necessário para instalações self-hosted do Kodus que desabilitam deliberadamente o BYOK. Se o BYOK estiver habilitado na sua instância self-hosted, prefira a Opção 1 ou a Opção 2 — a página AI providers funciona da mesma forma que no Cloud.
Reinicie os containers de API e worker após editar o .env, e verifique a integração:
Para a configuração completa self-hosted (domínios, chaves de segurança, banco de dados, webhooks, proxy reverso), siga o guia de implantação em VM genérica e substitua apenas o bloco de LLM pelo acima.

​
Escolhendo entre Kimi Code Plan, Developer API e agregadores

  • Kimi Code Plan — custo previsível de taxa fixa, limite de 30 simultâneas, endpoint dedicado api.kimi.com/coding/v1 otimizado para fluxos de codificação. Melhor para times em regime estável com volume previsível de PRs.
  • Moonshot Developer API — pay-per-token, simultaneidade escala com o tier de recarga, maior flexibilidade. Melhor para cargas variáveis.
  • Proxy OpenRouter — se você quer uma relação única de cobrança para muitos provedores, o OpenRouter expõe modelos Kimi com uma pequena margem de roteamento. Escolha isso quando o Kimi é parte de uma frota de múltiplos provedores, não uma carga principal.

​
Solução de problemas

  • Chaves do Kimi Code Plan funcionam apenas contra api.kimi.com/coding/v1.
  • Chaves da Developer API de platform.moonshot.ai funcionam apenas contra api.moonshot.ai/v1.
  • Chaves da Developer API de platform.moonshot.cn funcionam apenas contra api.moonshot.cn/v1.
  • O card Moonshot sempre usa https://api.moonshot.ai/anthropic, então precisa de uma chave de platform.moonshot.ai. Conecte chaves do Kimi Code Plan ou de platform.moonshot.cn via OpenAI-compatible com a Base URL correspondente.
  • A Developer API cobra pay-per-token. Se o saldo acabar, as requisições retornam HTTP 402.
  • Adicione fundos na seção de cobrança do console ou defina um limite mensal para evitar surpresas.
  • O Kimi Code Plan tem preço fixo, mas é limitado pelo seu limite de 30 simultâneas e janelas de cota — 429 significa que você atingiu um.
  • Confirme que o nome do modelo corresponde ao catálogo (kimi-k2.6, kimi-k2.6, kimi-k2.5, kimi-k2-0905, kimi-k2).
  • Verifique platform.kimi.ai/docs para a lista atual — novas versões são lançadas regularmente.
  • A primeira chamada após períodos de inatividade pode ter cold-start do lado da Moonshot.
  • Se a latência importa, kimi-k2-0905 geralmente é mais rápido que as variantes K2.6 para revisões rotineiras.
  • Usuários fora da China devem sempre usar api.moonshot.ai ou api.kimi.com. api.moonshot.cn pode ser inacessível ou ter taxa limitada fora da China continental.
  • Confirme que o HTTPS de saída para o endpoint escolhido é permitido na sua implantação do Kodus.

​
Relacionados