Como usar o Kimi K3.1 Pro?

Eis como usar o Kimi K3.1 Pro de quatro formas: conversar com ele no site ou no aplicativo móvel do Kimi, chamar kimi-k3.1-pro pela API compatível com a OpenAI em https://api.moonshot.ai/v1, executá-lo dentro do Kimi Code CLI com uma assinatura paga, ou apontar Codex, Claude Code ou OpenCode para os endpoints da Moonshot. A API é liberada após uma recarga de $1 e custa $2 por milhão de tokens de entrada e $10 por milhão de tokens de saída.

A Moonshot AI lançou o Kimi K3.1 Pro em 23 de outubro de 2026. É uma versão pós-treinada do Kimi K3 com o mesmo design MoE de 2,8T de parâmetros (cerca de 104B ativos), uma janela de contexto de 1.048.576 tokens e raciocínio sempre ativado. Se você quiser primeiro o contexto, leia o que é o Kimi K3.1 Pro. Se você quiser não gastar nada, nosso guia sobre como usar o Kimi K3.1 Pro de graça cobre as rotas de $0. Todos os fatos abaixo vêm do anúncio da Moonshot, do guia de início rápido da API e da página de preços, lidos em 24 de outubro de 2026.

Qual rota do Kimi K3.1 Pro você deve escolher?

Escolha de acordo com o que você está construindo. O chat serve para perguntas rápidas, a API serve para aplicativos, o Kimi Code serve para membros que querem um agente sem gerenciar chave, e seu próprio agente serve para equipes que já vivem no Codex ou no Claude Code.

Use o Kimi K3.1 Pro nos aplicativos web e móveis do Kimi

Os aplicativos de chat são a forma mais rápida de começar. Abra o aplicativo web do Kimi ou o aplicativo para iOS, Android ou HarmonyOS, faça login com uma conta gratuita, e o K3.1 Pro já é o modelo padrão no campo de composição, com o esforço de raciocínio definido como High.

Antes de fazer login, o campo de composição também lista K2.8 Preview e Instant. Enviar um prompt exige uma conta. A Moonshot não publica a cota de mensagens do K3.1 Pro no plano gratuito [VERIFY], então trate o chat como um campo de testes, não como um canal de produção.

O Kimi Work para desktop 3.1.0 e posteriores (Windows e Macs com Apple silicon) também executa o modelo. No Kimi Business e Enterprise, um administrador precisa ativá-lo, pois ele vem desligado por padrão no lançamento.

API do Kimi K3.1 Pro: primeira chamada em Python e cURL

A API do Kimi K3.1 Pro é compatível com a OpenAI, então o SDK padrão openai funciona com uma URL base alterada. A configuração leva três passos:

1. Recarregue pelo menos $1. O K3.1 Pro é um modelo de ponta e só é liberado após uma recarga bem-sucedida.
2. Crie uma chave no console de chaves de API e exporte-a como MOONSHOT_API_KEY.
3. Chame o modelo kimi-k3.1-pro (ou kimi-k3.1-pro-highspeed) em https://api.moonshot.ai/v1.

Aqui está o exemplo oficial em Python da Moonshot:

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)

A mesma chamada em cURL:

curl https://api.moonshot.ai/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model": "kimi-k3.1-pro","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'

O modelo aceita texto, imagens e vídeo como entrada (o guia de início rápido mostra as partes image_url e video_url) e retorna texto. Você também pode testar prompts no Playground antes de escrever código. Para padrões da era K3 que ainda se aplicam, veja nosso guia da API do Kimi K3.

Esforço de raciocínio do Kimi K3.1 Pro: low, high ou max

reasoning_effort é um campo de requisição de nível superior que define quanto o modelo pensa antes de responder. Ele aceita "low", "high" e "max", e o padrão é "max". O raciocínio não pode ser desligado. Não existe nível "medium".

O guia de esforço de raciocínio da Moonshot tem a referência completa. Como você paga tokens de saída a $10 por milhão, baixar de max para low em chamadas simples é a economia mais fácil que você encontrará. Deixe de fora temperature e top_p: o guia de início rápido os lista como fixos em 1.0 e 0.95.

Transmita o raciocínio, mantenha o estado multiturno, receba JSON de volta

Três comportamentos da API confundem as pessoas, e cada um tem uma regra simples.

Streaming. Uma resposta transmitida em stream envia deltas separados de reasoning_content e content. Mostre ou registre o primeiro, renderize o segundo:

stream = client.chat.completions.create(
    model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
    messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="")
    if delta.content:
        print(delta.content, end="")

Multiturno e chamadas de ferramentas. Envie de volta a mensagem completa do assistente, não apenas seu content. A documentação da Moonshot é explícita sobre isso, e isso importa mais quando chamadas de ferramentas estão envolvidas:

messages.append(completion.choices[0].message)  # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})

tool_choice: "required" é suportado quando você precisa que o modelo chame uma ferramenta. O modo parcial também funciona: termine suas mensagens com uma mensagem do assistente que tenha "partial": true e o modelo continua a partir dela.

Saída estruturada. Passe response_format com o tipo json_schema e strict: true, depois analise apenas message.content. Nunca analise o texto de raciocínio.

Kimi Code K3.1 Pro: a rota por assinatura

O Kimi Code é o agente de programação de terminal da própria Moonshot, e é a rota sem chave de API. Você faz login com sua conta Kimi em vez disso. É um benefício de assinatura, então o plano Adagio gratuito não o inclui.

Instale-o e faça login:

# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi

Dentro da sessão, execute /login, depois /model para escolher o K3.1 Pro. Os dois IDs correspondem aos níveis de plano:

• k3.1-pro: Moderato (Plus) e superiores. Allegretto (Pro) e superiores liberam até o contexto de 1M.
• k3.1-pro-highspeed: Allegretto (Pro) e superiores, usando cerca de 2x de cota.

Nos preços de assinatura, o Plus custa $15 por mês na cobrança anual ($19 mensal) e o Pro custa $31 por ano ($39 mensal). A documentação do Kimi Code cobre os comandos, e nosso passo a passo do Kimi Code CLI aprofunda o uso diário.

Kimi K3.1 Pro no Codex

O Codex conversa com o Kimi por meio da Responses API, e a Moonshot publica um guia oficial do Codex. Adicione isto ao ~/.codex/config.toml:

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

Observe o nome da variável de ambiente: o Codex lê KIMI_API_KEY, não MOONSHOT_API_KEY. Exporte sua chave da Moonshot com esse nome, depois inicie o codex como de costume.

Kimi K3.1 Pro no Claude Code

A Moonshot opera um endpoint Messages compatível com a Anthropic em https://api.moonshot.ai/anthropic, então o Claude Code funciona sem proxy. Coloque as variáveis no bloco env de ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]"
  }
}

O alias é intencional. A página de solução de problemas da Moonshot diz que chamadas diretas à API e o Codex usam kimi-k3.1-pro, enquanto o Claude Code usa o alias compatível kimi-k3[1m]. O guia do Claude Code define também as outras variáveis de modelo, então copie-as de lá.

Uma pegadinha: valores obsoletos no bloco env do arquivo de configurações substituem as variáveis exportadas no shell. Se o Claude Code continuar chamando um modelo antigo, verifique esse arquivo primeiro.

OpenCode

O OpenCode não precisa de arquivo de configuração. Execute opencode auth login, selecione “Moonshot AI”, cole sua chave, depois escolha o K3.1 Pro entre os modelos da Moonshot AI. O guia do OpenCode da Moonshot foi escrito para o K3, então confirme se o modelo aparece na sua lista [VERIFY].

Deixe seu agente testar a API do Kimi com o Apidog CLI

Assim que o Codex ou o Claude Code estiver rodando no K3.1 Pro, coloque essa mesma sessão para trabalhar em testes de regressão para a própria API do Kimi. Seu agente escreve e executa as verificações; você escreve um prompt. O Apidog CLI fornece a ele saída JSON estruturada e esquemas, então ele não adivinha os formatos de payload.

Instale o CLI, faça login e adicione a habilidade de agente:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install

Depois dê ao seu agente um prompt:

In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.

O agente cria o ambiente, lê o esquema, valida seu payload, escreve o caso de teste e o executa:

apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Os casos de teste precisam de uma categoria válida, e apidog test-case category --project <projectId> as lista. Um 200 com uma resposta não vazia também prova que a API aceitou reasoning_effort. Troque por -r junit e a mesma execução entra no CI, como mostra nosso guia de CI/CD do Apidog CLI. A configuração específica para agentes está em Apidog CLI no Codex e Apidog CLI no Claude Code. O plano gratuito do Apidog cobre até 4 usuários.

Notas de custo do Kimi K3.1 Pro

A API é paga conforme o uso, sem assinatura, e os preços não incluem impostos.

O K3.1 Pro é um terço mais barato que o K3 em entrada e saída. O cache é automático para prefixos repetidos, com TTL padrão de 5 minutos, e os acertos de cache são cobrados a $0.20. O Highspeed roda 2-3x mais rápido pelo dobro do preço.

Sua recarga mínima de $1 compra cerca de 500K tokens de entrada ou 100K tokens de saída. Quando suas recargas acumuladas atingem $5, você ganha um voucher de $5, mas os vouchers não contam para a recarga acumulada, e não está declarado se eles se aplicam ao K3.1 Pro [VERIFY]. Uma conta de $1 começa no Tier0 na página de limites: 1 requisição simultânea, 3 RPM e 1,5M de tokens por dia. O Tier1 em $10 acumulados eleva isso para 100 RPM.

FAQ

O Kimi K3.1 Pro tem pesos abertos?

Ainda não. A Moonshot diz que os pesos completos do modelo serão lançados até 4 de novembro de 2026. A licença não foi declarada.

Qual é a diferença entre o K3.1 Pro e o K3.1 Pro Highspeed?

Mesma família de modelos, velocidade e preço diferentes. O Highspeed roda 2-3x mais rápido e custa $4/$20 por milhão de tokens contra $2/$10. No Kimi Code ele exige o plano Pro e usa cerca de 2x de cota.

Posso desligar o raciocínio no Kimi K3.1 Pro?

Não. O raciocínio está sempre ativado. Defina reasoning_effort como "low" para reduzir tokens de raciocínio e latência.

Por que minha conversa multiturno quebra?

Você provavelmente está enviando de volta apenas o content do assistente. Acrescente o objeto completo da mensagem do assistente ao seu histórico, como a documentação da Moonshot exige para conversas multiturno e chamadas de ferramentas.

A API do Kimi é gratuita?

Não. O K3.1 Pro é liberado após uma recarga mínima de $1. O chat gratuito no aplicativo Kimi é a opção de $0, abordada em nosso guia gratuito.

O Kimi K3.1 Pro suporta uma janela de contexto de 1M?

Sim. A API suporta 1.048.576 tokens. No Kimi Code, o contexto completo de 1M exige Allegretto (Pro) ou superior.