Skip to Content

Série Kimi

Os modelos Kimi da Moonshot AI, incluindo Kimi K3, K2.6 e o K2.7 Code, voltado para programação. São chamados pela API compatível com OpenAI e também suportam o endpoint nativo Anthropic, podendo ser usados no Claude Code.

Tarefas comuns

Modelos

A lista completa de modelos e os preços atualizados estão na página de modelos . O prefixo dos IDs de modelo é moonshotai/ e pode ser omitido.

IDs de modelo comuns (copie exatamente)
Kimi K3moonshotai/kimi-k3Contexto de 1M, aceita imagens
Kimi K2.6moonshotai/kimi-k2.6Contexto de 256K, aceita imagens
Kimi K2.7 Codemoonshotai/kimi-k2.7-codeVoltado para programação

Os modelos Kimi são fornecidos pela Moonshot AI oficial (moonshot); alguns modelos também contam com provedores como Azure AI Foundry e Alibaba Cloud Model Studio, com seleção automática por padrão. Para escolher um provedor, veja Roteamento de provedores.

Exemplos de chamada

kimi_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="moonshotai/kimi-k3", messages=[{"role": "user", "content": "Explique em uma frase o que é idempotência."}], extra_body={"thinking": {"type": "disabled"}}, ) print(resp.choices[0].message.content)

Modo thinking

ResumoO Kimi ativa o thinking por padrão. Quando não precisar dele, defina o type de thinking como disabled (exceto no K2.7 Code HighSpeed).
ModeloPadrãoDesativar o thinking
Kimi K3, K2.6, K2.7 CodeAtivado"thinking": {"type": "disabled"}
Kimi K2.7 Code HighSpeedAtivadoNão suportado; enviar disabled retorna 400

Medição com o mesmo problema de matemática: o Kimi K3 levou cerca de 30 segundos por padrão e cerca de 3 segundos com o thinking desativado; o K2.6, por padrão, usou cerca de 11 mil tokens de thinking e levou cerca de 4,5 minutos, e cerca de 40 segundos com o thinking desativado. Os tokens de thinking são cobrados pelo preço de saída, e a quantidade aparece em usage.completion_tokens_details.reasoning_tokens.

Para ler o conteúdo do thinking: em respostas em streaming, ele fica em delta.reasoning_content; em respostas sem streaming, fica em message.reasoning_details, e você deve concatenar o text de cada item em ordem.

Adicione web_search a tools no endpoint Responses; o modelo faz a busca por conta própria e anexa as fontes citadas à resposta:

kimi_web_search.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.responses.create( model="moonshotai/kimi-k3", tools=[{"type": "web_search"}], input="Qual é a versão estável mais recente do Python?", ) print(resp.output_text) for item in resp.output: if item.type == "message": for part in item.content: for a in getattr(part, "annotations", None) or []: print("Fonte:", a.title, a.url)
  • Nos testes, Kimi K3 e K2.6 suportam o recurso. Em output aparecem, em ordem, os itens reasoning, web_search_call e message, e as fontes citadas ficam em annotations no conteúdo de message.
  • A busca é cobrada por chamada; o preço unitário está na página do modelo .

Usar no Claude Code

Os modelos Kimi suportam o endpoint nativo Anthropic, no endereço https://api.ofox.ai/anthropic:

Valores de configuração do Claude Code
ANTHROPIC_BASE_URLhttps://api.ofox.ai/anthropic
ANTHROPIC_AUTH_TOKENCole sua API key da OfoxAI
ANTHROPIC_MODELmoonshotai/kimi-k2.7-code

Pelo endpoint Anthropic, o conteúdo do thinking é retornado em blocos thinking. As etapas completas de configuração do Claude Code estão em Configuração do Claude Code.

Entrada de imagens e saída estruturada

  • Kimi K3 e K2.6 aceitam entrada de imagens, com o bloco de conteúdo padrão image_url. Veja como em Visão.
  • response_format aceita json_schema e json_object; a chamada de ferramentas usa o parâmetro padrão tools. Veja como em Saída estruturada.
  • Prefixos de requisição repetidos são armazenados em cache automaticamente; os acertos aparecem em usage.prompt_tokens_details.cached_tokens.

Erros comuns

HTTP · typeMensagem de erro originalCausaSolução
400 invalid_request_errorinvalid thinking: only type=enabled is allowed for this modelO K2.7 Code HighSpeed não permite desativar o thinkingRemova o parâmetro thinking ou use o K2.7 Code
429 rate_limit_errorRate limit reached for the requested model. Please retry after a short delay.Requisições frequentes demaisTente novamente mais tarde; veja Limites de taxa
404 model_not_foundModel 'moonshotai/kimi-k9' not foundID do modelo digitado errado ou uso do prefixo moonshot/O prefixo é moonshotai/; copie o ID do modelo desta página
Timeout da requisição—Com o thinking ativado por padrão, problemas complexos demoram maisDesative o thinking, use streaming ou defina o timeout do cliente em 600 segundos ou mais

Outros erros gerais em Tratamento de erros.

Documentação oficial

Perguntas frequentes

Como escrever o ID de modelo do Kimi?

A forma padrão é moonshotai/kimi-k3; também é possível omitir o prefixo e escrever kimi-k3. Escrever moonshot/kimi-k3 retorna 404.

Como desativar o thinking do Kimi?

Envie "thinking": {"type": "disabled"}; no OpenAI SDK, coloque-o em extra_body. O K2.7 Code HighSpeed não permite desativar, e enviar o parâmetro retorna 400.

O Kimi consegue buscar na web?

Sim. Use o endpoint Responses e adicione {"type": "web_search"} a tools; a resposta virá com as fontes citadas. Nos testes, Kimi K3 e K2.6 suportam o recurso.

O Claude Code funciona com o Kimi?

Sim. Defina ANTHROPIC_BASE_URL como https://api.ofox.ai/anthropic e informe o modelo moonshotai/kimi-k2.7-code ou moonshotai/kimi-k3.

Por que o Kimi K2.6 é tão lento?

O K2.6 ativa o thinking por padrão, e problemas complexos podem consumir dezenas de milhares de tokens de thinking e levar vários minutos. Desative o thinking quando não precisar dele ou use o Kimi K3.

Última atualização em