Pular para o conteúdo principal

Kimi Code

O Libre WebUI inclui um plugin de provedor Kimi Code integrado para a API de programação compatível com OpenAI da Moonshot AI.

Configurar o provedor​

Crie uma chave de API no Console do Kimi Code e salve-a para o seu usuário em Configurações > Plugins > Kimi Code (Moonshot AI) ou forneça-a como variável de ambiente para toda a implantação:

KIMI_API_KEY=...

Ative o plugin depois de salvar a credencial. Os modelos dele aparecerão no seletor de modelos.

Modelos disponíveis​

ID do modeloModeloDisponibilidade
k3Kimi K3Moderato e superior; contexto de até 1M nos níveis qualificados
k3-256kKimi K3Moderato e superior; contexto fixo de 256K
kimi-for-codingKimi K2.7 CodeTodos os membros do Kimi Code
kimi-for-coding-highspeedKimi K2.7 Code HighSpeedAllegretto e superior; mais velocidade e maior consumo de cota

O Kimi documenta o K3 como compatível com uma janela de contexto de até um milhão de tokens nos níveis de assinatura qualificados. O Libre WebUI não define o esforço de raciocínio do K3, portanto a API do Kimi aplica o padrão documentado, atualmente high.

Os modelos Kimi Code escolhem valores fixos de amostragem para o modo de raciocínio ativo. Por isso, o Libre WebUI não envia as configurações globais de temperatura, top-p, penalidade de frequência ou penalidade de presença para esse provedor. Isso segue a recomendação do Kimi e evita erros de parâmetro inválido quando os padrões mudam.

Endpoint da API​

O plugin integrado usa o endpoint do Kimi Code compatível com OpenAI:

https://api.kimi.com/coding/v1/chat/completions

O endpoint pode ser substituído nas variáveis do plugin para gateways ou proxies compatíveis. Substituições por HTTP são aceitas em gateways auto-hospedados, mas enviam a chave de API e o conteúdo da solicitação sem criptografia de transporte. Use HTTP somente em uma rede confiável e prefira HTTPS sempre que o gateway oferecer TLS.

Privacidade e uso​

O Kimi Code é um provedor remoto. Prompts, contexto da conversa e conteúdo anexado enviados por esse plugin são processados pelo Kimi de acordo com seus termos e sua política de privacidade. Use credenciais por usuário em implantações compartilhadas para que cada pessoa controle a própria conta, cota e cobrança.

O Kimi pede que clientes de terceiros preservem sua identidade real. Não configure um proxy para se passar por outro produto nem altere a identificação do cliente para obter um acesso diferente.

Solução de problemas​

Não autorizado ou HTTP 401

  • Confirme que a chave de API veio do Console do Kimi Code.
  • Confirme que o modelo selecionado está incluído no seu nível de assinatura.
  • O K3 exige Moderato ou superior, e o HighSpeed exige Allegretto ou superior.

O contexto do K3 é menor que o esperado

  • Os limites de contexto do K3 dependem da assinatura.
  • O Moderato oferece um contexto K3 menor que o Allegretto e os níveis superiores.
  • Selecione k3-256k quando quiser explicitamente a rota K3 de 256K com cota menor.
  • Inicie um novo chat após trocar de família de modelos para evitar reutilizar um cache de contexto incompatível.

HTTP 429

  • Leia a mensagem do provedor exibida na atividade do Work. O Kimi distingue sobrecarga temporária do mecanismo, limites de solicitações simultâneas, limites de uso contínuo e esgotamento da cota mensal.
  • Tente novamente após o intervalo indicado em casos de sobrecarga temporária. Erros de cota exigem aguardar a redefinição ou mudar o plano da conta.

O modelo não aparece

  • Ative o plugin Kimi Code.
  • Confirme que a chave de API está salva para o usuário atual ou disponível como KIMI_API_KEY.
  • Recarregue a lista de modelos depois de alterar as configurações do plugin.

Documentação relacionada​