Como Usar a API de Código Kimi K2.7

A API Kimi K2.7 Code oferece o modelo de um trilhão de parâmetros do Moonshot, ajustado para codificação, através de um endpoint compatível com OpenAI. Se você pode chamar a API OpenAI, pode chamar esta; troque a URL base, defina o ID do modelo, e pronto. Há também um endpoint compatível com Anthropic para que ele se integre diretamente ao Claude Code.

Este guia cobre as duas formas de acessá-lo, a URL base exata e os IDs de modelo, código funcional em curl, Python e Node, o preço e como testar tudo no Apidog antes de implantar.

button

TL;DR

URL Base: https://api.moonshot.ai/v1 (compatível com OpenAI). Para Claude Code, use https://api.moonshot.ai/anthropic.
ID do Modelo: kimi-k2.7-code na API Moonshot de pagamento por token; kimi-for-coding na assinatura Kimi Code.
Preços: $0,95 por milhão de tokens de entrada, $4,00 por milhão de saída, $0,19 por milhão em acertos de cache.
Obtenha uma chave no console da plataforma Kimi, e então chame-a como qualquer endpoint OpenAI.
O modelo sempre raciocina (o pensamento é forçado), então espere tokens de raciocínio em cada resposta.

Duas formas de acessar o modelo

Escolha o caminho que corresponde à forma como você o usará.

API de desenvolvedor com pagamento por token. Faturamento padrão baseado no uso através da API Moonshot. ID do modelo kimi-k2.7-code, URL base https://api.moonshot.ai/v1. É o que você precisa para tráfego de produção, scripts e qualquer coisa programática.

Assinatura Kimi Code. Um plano de taxa fixa vinculado ao CLI Kimi Code e ao console. As chaves do console Kimi Code usam o ID do modelo kimi-for-coding e cobram contra uma cota que é atualizada a cada 7 dias, em vez de por token. Melhor para codificação interativa pesada, onde os custos por token se acumulariam.

O restante deste guia usa a API de pagamento por token, pois é a que você chama a partir do seu próprio código.

Passo 1: Obtenha uma chave de API

Faça login no console da plataforma Kimi.
Crie uma chave e copie-a. Você não a verá novamente, então armazene-a em um gerenciador de segredos ou em uma variável de ambiente.
Exporte-a localmente:

export MOONSHOT_API_KEY="sk-your-key-here"

Trate a chave como uma senha. Não a inclua no controle de versão e não a cole em código do lado do cliente.

Passo 2: Faça sua primeira requisição

O endpoint espelha as conclusões de chat do OpenAI, então uma simples chamada curl funciona:

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.7-code",
    "messages": [
      {"role": "system", "content": "You are a careful senior engineer."},
      {"role": "user", "content": "Write a Python function that validates an email and returns a clear error message."}
    ]
  }'

Você receberá de volta uma resposta padrão no formato OpenAI: um array choices com a mensagem, além de um objeto usage mostrando a contagem de tokens de entrada, saída e raciocínio.

Passo 3: Chame-o do Python

Por ser compatível com OpenAI, o SDK oficial openai funciona com uma mudança na URL base:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

resp = client.chat.completions.create(
    model="kimi-k2.7-code",
    messages=[
        {"role": "user", "content": "Refactor this loop for readability and explain why."},
    ],
)

print(resp.choices[0].message.content)
print(resp.usage)

Nenhum novo cliente, nenhuma camada HTTP personalizada. O mesmo código que se comunica com o GPT agora se comunica com o Kimi.

Passo 4: Chame-o do Node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MOONSHOT_API_KEY,
  baseURL: "https://api.moonshot.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "kimi-k2.7-code",
  messages: [
    { role: "user", content: "Write a Jest test for an empty-input edge case." },
  ],
});

console.log(resp.choices[0].message.content);

O que saber sobre o comportamento do modelo

Algumas peculiaridades moldam a forma como você o chama.

O pensamento está sempre ativado. O K2.7 Code força o raciocínio e o mantém em todas as interações. Cada resposta carrega tokens de raciocínio, pelos quais você paga como saída. A vantagem é que ele raciocina cerca de 30% mais eficientemente do que o K2.6, então a conta é mais leve do que a geração anterior para o mesmo trabalho.

A chamada de ferramentas funciona como no OpenAI. Passe um array tools com esquemas de função e o modelo retorna objetos de chamada de ferramenta que você executa e alimenta de volta. Ele é ajustado para o uso de ferramentas em várias etapas, então ele lida com longas cadeias sem perder o controle.

É multimodal. Você pode enviar conteúdo de imagem no array messages para tarefas como ler uma captura de tela de uma UI com falha ou um diagrama.

Preços e limites de taxa

As taxas de pagamento por token:

Tipo de Token	Preço por milhão
Entrada	$0.95
Saída (incl. raciocínio)	$4.00
Acerto de cache	$0.19

Duas coisas mantêm os custos baixos. Acertos de cache são cobrados por uma fração do preço de entrada, então prompts de sistema repetidos e contexto compartilhado se tornam baratos. E o orçamento de raciocínio reduzido significa menos tokens de saída por tarefa do que o K2.6. Para mais táticas, consulte nosso guia sobre redução de custos de token de agente. Se você quiser os números da geração anterior para comparação, nosso guia da API Kimi K2.6 e guia da API DeepSeek V4 cobrem esses tópicos.

Use-o dentro do Claude Code, Cline ou Cursor

Você não precisa escrever um cliente para colocar o K2.7 Code para funcionar no seu editor.

Claude Code. Aponte-o para o endpoint compatível com Anthropic:

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.7-code"

Cline e RooCode. Selecione Moonshot como provedor, escolha o endpoint api.moonshot.ai, cole sua chave e selecione kimi-k2.7-code como o modelo. Desative a ferramenta do navegador para um funcionamento mais suave.

Cursor. Adicione o modelo através de um endpoint personalizado compatível com OpenAI com a mesma URL base e chave. A configuração espelha nosso guia Kimi-no-Cursor; apenas o ID do modelo muda.

Teste e depure a API no Apidog

Antes de conectar a API a um agente, confirme exatamente o que ela retorna. O Apidog oferece um ambiente de trabalho visual para enviar requisições, inspecionar respostas e fixar testes.

Crie uma requisição POST para https://api.moonshot.ai/v1/chat/completions.
Adicione o cabeçalho Authorization: Bearer {{MOONSHOT_API_KEY}}, armazenando a chave como uma variável de ambiente do Apidog para que ela nunca fique em texto simples.
Envie um corpo no estilo OpenAI com "model": "kimi-k2.7-code" e suas messages.
Execute-o. O Apidog formata o JSON, exibe as contagens de tokens de usage e salva a chamada.
Transforme a chamada em um teste: afirme que o status é 200, que choices[0].message.content não está vazio e que usage.completion_tokens permanece dentro do orçamento que você definiu.

Agora você tem um teste de regressão que pode executar novamente a cada atualização do modelo. Se você está exercitando as chamadas de ferramenta do modelo através do MCP, nosso manual de testes de servidor MCP mostra as asserções que pegam contratos de ferramentas quebrados. Baixe o Apidog para configurá-lo.

FAQ

Qual é a URL base da API? https://api.moonshot.ai/v1 para chamadas compatíveis com OpenAI, https://api.moonshot.ai/anthropic para Claude Code.

Qual ID de modelo devo usar? kimi-k2.7-code na API de pagamento por token. A assinatura Kimi Code usa kimi-for-coding.

É compatível com OpenAI? Sim. O formato de requisição e resposta corresponde às conclusões de chat do OpenAI, então SDKs existentes funcionam com uma mudança na URL base. Há também um endpoint compatível com Anthropic.

Quanto custa? $0,95 por milhão de tokens de entrada, $4,00 por milhão de saída e $0,19 por milhão em acertos de cache.

Sempre pago por tokens de raciocínio? Sim. O pensamento é forçado, então cada resposta inclui tokens de raciocínio cobrados na taxa de saída. Ainda assim, usa cerca de 30% menos do que o K2.6.

Posso enviar imagens? Sim. O modelo é multimodal, então conteúdo de imagem no array de mensagens é suportado.

Resumo

A API Kimi K2.7 Code está a uma troca de URL base de qualquer cliente compatível com OpenAI: acesse https://api.moonshot.ai/v1, use o ID do modelo kimi-k2.7-code e pague $0,95/$4,00 por milhão de tokens. Para codificação interativa, a assinatura Kimi Code de taxa fixa com kimi-for-coding pode custar menos. Ele se conecta ao Claude Code, Cline, RooCode e Cursor com uma mudança de configuração, e você pode validar tudo no Apidog antes de confiar nele em produção. Obtenha uma chave, envie a chamada curl acima e verifique o uso de tokens para ver como o preço se ajusta à sua carga de trabalho.

button