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.
moonshotai/kimi-k3Contexto de 1M, aceita imagensmoonshotai/kimi-k2.6Contexto de 256K, aceita imagensmoonshotai/kimi-k2.7-codeVoltado para programaçãoOs 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
Python
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
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.
Busca na web
Adicione web_search a tools no endpoint Responses; o modelo faz a busca por conta própria e anexa as fontes citadas à resposta:
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
outputaparecem, em ordem, os itensreasoning,web_search_callemessage, e as fontes citadas ficam emannotationsno conteúdo demessage. - 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:
https://api.ofox.ai/anthropicmoonshotai/kimi-k2.7-codePelo 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_formataceitajson_schemaejson_object; a chamada de ferramentas usa o parâmetro padrãotools. 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
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.