Como chamar o Kimi K2.6 pela API da Moonshot sem errar o model ID

Para usar o Kimi K2.6 pela API oficial da Moonshot, o endpoint quase nunca é a parte que derruba a integração. A Kimi Open Platform informa que suas APIs HTTP são compatíveis com o formato da OpenAI, que você pode usar o OpenAI SDK diretamente e que, ao usar SDKs, o base_url deve ser https://api.moonshot.ai/v1; em chamadas HTTP diretas, o caminho completo de chat é https://api.moonshot.ai/v1/chat/completions.

A pegadinha está no model. A página de List Models informa que o Kimi K2.6 foi lançado, mas o exemplo de resposta mostrado na documentação ainda ilustra o campo id como kimi-k2.5. Por isso, o caminho mais seguro é chamar

GET /models

Endpoints e configurações que importam

Caso de uso	Configuração ou endpoint	Observação
Usar OpenAI SDK	base_url = https://api.moonshot.ai/v1	A Kimi descreve a API como compatível com OpenAI e permite usar o OpenAI SDK diretamente.
Chat em tempo real	POST https://api.moonshot.ai/v1/chat/completions	O overview da API mostra esse caminho completo; a documentação de Chat usa request com model e messages.
Listar modelos	GET https://api.moonshot.ai/v1/models	O endpoint retorna a lista de modelos e o exemplo de resposta tem o campo id.
Ver saldo	GET https://api.moonshot.ai/v1/users/me/balance	A documentação de balance usa autenticação Authorization: Bearer ... .
Criar batch	POST https://api.moonshot.ai/v1/batches	A documentação de Batch API mostra esse endpoint para criar jobs em lote.

Fluxo seguro para chamar o Kimi K2.6

1. Prepare a API key da Moonshot. Os exemplos da Kimi usam autenticação por header

   Authorization: Bearer ...

   ; a documentação de integração do TypingMind também descreve o fluxo de criar uma conta Moonshot API, adicionar saldo e obter a API key.
2. Configure o cliente como OpenAI-compatible. Se usar o OpenAI SDK, o ponto essencial é trocar o base_url para https://api.moonshot.ai/v1.
3. Chame /models antes do request real. O endpoint List Models existe para listar os modelos disponíveis e o exemplo de resposta inclui o campo id; é esse valor que deve entrar no parâmetro model.
4. Envie o chat com model e messages. A documentação de Chat mostra a estrutura de request com model e messages, enquanto o overview da API informa o endpoint /chat/completions.
5. Cheque saldo ou use batch quando fizer sentido. A Kimi oferece endpoint de balance para verificar a conta e endpoint de batch para criar trabalhos em lote.

Exemplo em Python com OpenAI SDK

O exemplo abaixo usa o base_url publicado pela Kimi para o OpenAI SDK. A variável KIMI_MODEL_ID deve ser preenchida com o id obtido em

GET /models

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model=os.environ["KIMI_MODEL_ID"],
    messages=[
        {"role": "user", "content": "Olá, faça uma apresentação curta de você."}
    ],
)

print(response)

Exemplo com cURL: pegue o model ID antes do chat

Comece listando os modelos disponíveis na sua conta Moonshot/Kimi, porque esse endpoint retorna a lista de modelos com o campo id.

curl -sS https://api.moonshot.ai/v1/models \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

Depois de escolher o id correto na resposta, envie o request para Chat Completions. O caminho completo /chat/completions e a estrutura model + messages são descritos pela documentação da Kimi.

curl -sS https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "PASTE_MODEL_ID_FROM_MODELS",
    "messages": [
      {"role": "user", "content": "Escreva uma apresentação curta sobre o Kimi K2.6."}
    ]
  }'

Como verificar saldo da API

Se uma chamada falhar por cobrança ou se você quiser validar a conta antes de integrar em produção, a Kimi documenta o endpoint /users/me/balance e usa Bearer token no exemplo.

curl -sS https://api.moonshot.ai/v1/users/me/balance \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

Não misture model ID da Moonshot com IDs de gateways

Alguns provedores intermediários usam IDs próprios para o Kimi K2.6. A AIMLAPI usa o endpoint https://api.aimlapi.com/v1/chat/completions com o model moonshot/kimi-k2-6. Já o OpenRouter exibe o model moonshotai/kimi-k2.6 em sua página de API.

Esses IDs fazem sentido quando você chama o gateway correspondente. Para o endpoint oficial https://api.moonshot.ai/v1/chat/completions, a opção menos arriscada é chamar

GET https://api.moonshot.ai/v1/models

Em resumo

O fluxo mais limpo é: obter a API key, configurar o OpenAI SDK com base_url em https://api.moonshot.ai/v1, consultar /models para confirmar o ID do Kimi K2.6 e só então enviar o request para /chat/completions com model e messages. Assim você segue a documentação OpenAI-compatible da Kimi e evita o erro comum de copiar o ID de AIMLAPI ou OpenRouter para o endpoint oficial da Moonshot.