Pular para o conteúdo principal

​
Como o Moonshot funciona

O Moonshot AI publica a família de modelos Kimi (Kimi K2, K2 Thinking, K2.5). O Kimi é particularmente forte em compreensão de código de contexto longo e tarefas agênticas, e a API é totalmente compatível com OpenAI, então o Kodus se comunica com ele usando o adaptador OpenAI-compatível existente.
As assinaturas de consumidor do Moonshot (Andante, Moderato, etc.) se aplicam ao produto de chat Kimi.ai, não à API. O uso da API é cobrado por token independentemente de qualquer assinatura de chat que você tenha. Isso é diferente de provedores como o Z.AI, onde a assinatura concede cota de API diretamente.
O Moonshot opera duas plataformas paralelas:
  • Internacional — platform.moonshot.ai — URL base https://api.moonshot.ai/v1. Cobrado em USD. Este é o padrão para usuários fora da China.
  • China — platform.moonshot.cn — URL base https://api.moonshot.cn/v1. Cobrado em CNY. Use apenas se você já opera dentro da China continental.

​
Modelos Recomendados

Para o catálogo e preços mais atualizados, consulte platform.moonshot.ai.
ModeloPreço (1M tokens entrada / saída)Janela de ContextoNotas
Kimi K2.5 recomendado0,60/0,60 / 2,50~256k tokensGeração mais recente, melhores resultados de codificação.
Kimi K2 Thinking~0,60/0,60 / 2,50~256k tokensVariante de raciocínio; use quando a revisão precisar de análise mais profunda.
Kimi K2 (0905)preço menor~128k tokensModelo estável de propósito geral.
Os três são acessíveis pela mesma URL base com nomes de model diferentes:
  • kimi-k2.5
  • kimi-k2-thinking
  • kimi-k2-0905
  • kimi-k2

​
Criando uma Chave de API

Uma conta Moonshot é necessária para criar uma chave de API.
  1. Vá para platform.moonshot.ai e crie uma conta (ou faça login). Usuários dentro da China continental devem usar platform.moonshot.cn.
  2. Adicione um método de pagamento — o Moonshot não oferece teste gratuito obrigatório na plataforma internacional; um pequeno crédito pode ser concedido quando você adiciona a cobrança pela primeira vez.
  3. Abra a seção Chaves de API no console.
  4. Clique em Criar Chave de API, dê um nome descritivo (ex.: kodus-prod) e copie a chave imediatamente.

​
Configurar o Moonshot no Kodus

O fluxo principal é BYOK no Kodus Cloud — você cola a chave do Moonshot na interface e pronto. Usuários self-hosted que preferem fixar o provedor no nível do processo podem usar variáveis de ambiente.

​
Opção 1 — BYOK no Kodus Cloud (recomendado)

  1. Na interface do Kodus, abra Configurações → BYOK e clique em Editar no modelo Principal (ou Fallback, se quiser o Kimi como backup).
  2. Alterne o formulário para o modo Personalizado para poder inserir uma URL base e um nome de modelo.
  3. Preencha os campos:
    CampoValor
    ProvedorOpenAI Compatible
    Chave de APIsua chave de API do Moonshot
    URL Basehttps://api.moonshot.ai/v1 (internacional)
    https://api.moonshot.cn/v1 (somente China continental)
    Modelokimi-k2.5 (recomendado) — ou kimi-k2-thinking, kimi-k2-0905, kimi-k2
    Máx. de Requisições Simultâneas5–10 é um bom ponto de partida; o Moonshot tem limites generosos por conta
    Máx. de Tokens de Entradavocê pode aumentar para a janela de 256k do K2.5; mantenha o padrão caso contrário
  4. Salve. O Kodus valida a chave no endpoint e exibe qualquer erro 401 / 404 imediatamente.
  5. Abra qualquer PR para acionar uma revisão e confirme que o Moonshot está respondendo — o badge de status BYOK nas Configurações fica verde na primeira chamada bem-sucedida.
O contexto longo do Kimi K2.5 brilha em PRs grandes e em código que abrange muitos arquivos. Se suas revisões são principalmente PRs pequenos, o kimi-k2-0905 é mais rápido e barato com essencialmente a mesma qualidade para essa carga de trabalho.
Você pode configurar o Moonshot como Principal e manter uma chave OpenAI ou Anthropic como Fallback — se o Moonshot retornar 429 ou 402, o Kodus realiza o failover automaticamente.

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

Se você executa o Kodus em Modo Fixo (provedor global único, sem BYOK por organização), configure o Moonshot no .env dos seus containers de API e worker: 
# Configuração Moonshot (Kimi) (Modo Fixo)
API_LLM_PROVIDER_MODEL="kimi-k2.5"
API_OPENAI_FORCE_BASE_URL="https://api.moonshot.ai/v1"    # use .cn para a plataforma da China
API_OPEN_AI_API_KEY="sua-chave-de-api-moonshot"
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 — o fluxo pela interface é o mesmo do Cloud.
Reinicie os containers de API e worker após editar o .env, e verifique a integração: 
docker-compose logs api worker | grep -iE "moonshot|kimi"
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 o Moonshot e um agregador

Você também pode alcançar o Kimi K2.5 pelo OpenRouter, que já é suportado como provedor de primeira classe no Kodus. A comparação:
  • API direta do Moonshot — menor custo por token, maior janela de contexto, limites de taxa nativos. Requer conta e cobrança no Moonshot.
  • Proxy OpenRouter — único relacionamento de cobrança para muitos provedores, mas uma pequena sobretaxa de roteamento e cold starts ligeiramente mais lentos.
Escolha o Moonshot direto quando o Kimi for seu modelo principal e quiser o melhor custo e contexto. Escolha o OpenRouter quando estiver usando muitos provedores e preferir uma única fatura.

​
Solução de problemas

  • Confirme que a chave está ativa no console do Moonshot.
  • Verifique se a URL base corresponde à plataforma na qual a chave foi criada — chaves de platform.moonshot.ai não funcionam em api.moonshot.cn e vice-versa.
  • Certifique-se de que não há espaços em excesso ou aspas no valor do .env.
  • O Moonshot cobra por token sem assinatura obrigatória. 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.
  • Confirme que o nome do modelo corresponde ao catálogo (kimi-k2.5, kimi-k2-thinking, kimi-k2-0905, kimi-k2).
  • Novas versões de modelo são lançadas regularmente — verifique os docs do Kimi para a lista atual.
  • A primeira chamada após um período de inatividade pode ter cold-start do lado do Moonshot.
  • Se a latência importa, prefira kimi-k2-0905 em vez da variante de raciocínio para revisões de código rotineiras.
  • Usuários fora da China devem sempre usar api.moonshot.ai; api.moonshot.cn pode ser inacessível ou ter taxa limitada fora da China continental.
  • Confirme que o HTTPS de saída para api.moonshot.ai é permitido na sua implantação do Kodus.

​
Relacionados