Para integrar Kimi K2.6 por API conviene separar dos cosas: la ruta oficial de Moonshot y el valor exacto de model que se envía en el cuerpo de la solicitud. Kimi Open Platform indica que sus API HTTP son compatibles con OpenAI, que se puede usar directamente el SDK de OpenAI y que, al usar SDK, hay que configurar base_url como https://api.moonshot.ai/v1; si llamas por HTTP directo, la ruta completa para chat es https://api.moonshot.ai/v1/chat/completions. ^[13]

La parte delicada es el identificador del modelo. La página de List Models anuncia que Kimi K2.6 ya fue publicado, pero el ejemplo de respuesta mostrado en la documentación todavía ilustra un id como kimi-k2.5. Por eso, la forma más segura no es adivinar el nombre: llama a

GET /models

[17]

Endpoints de Moonshot que debes tener a mano

Necesidad	Configuración o endpoint	Nota práctica
Usar el SDK de OpenAI	base_url = https://api.moonshot.ai/v1	Kimi describe su API como compatible con OpenAI y permite usar el SDK de OpenAI directamente. [13]
Enviar un chat en tiempo real	POST https://api.moonshot.ai/v1/chat/completions	El overview de la API muestra esta ruta completa; la documentación de Chat API usa una solicitud con model y messages. [13][14]
Listar modelos disponibles	GET https://api.moonshot.ai/v1/models	El endpoint devuelve una lista de modelos y el ejemplo incluye el campo id. [17]
Comprobar saldo	GET https://api.moonshot.ai/v1/users/me/balance	La documentación de balance usa autenticación con Authorization: Bearer . [15]
Crear un batch	POST https://api.moonshot.ai/v1/batches	La documentación de Batch API muestra el endpoint para crear trabajos por lotes. [16]

Flujo recomendado para no equivocarte de modelo

1. Prepara tu API key de Moonshot. Los ejemplos de la API de Kimi usan el header

   Authorization: Bearer ...

   ; la documentación de integración de TypingMind también describe el flujo de crear una cuenta Moonshot API, añadir saldo y obtener la API key. ^[2][15][17]
2. Configura el cliente como OpenAI-compatible. Si usas el SDK de OpenAI, el cambio importante es apuntar base_url a https://api.moonshot.ai/v1. ^[13]
3. Llama primero a /models. El endpoint List Models sirve para ver los modelos disponibles y su respuesta incluye el campo id; ese es el valor que debes pasar como model. ^[17]
4. Envía el chat con model y messages. La documentación de Chat API usa esa estructura de solicitud, y el overview de Kimi identifica /chat/completions como la ruta completa para llamadas HTTP directas. ^[13][14]
5. Verifica saldo o usa batch si lo necesitas. Kimi documenta un endpoint de balance para consultar la cuenta y un endpoint de batch para crear trabajos por lotes. ^[15][16]

Ejemplo en Python con el SDK de OpenAI

Este ejemplo usa el base_url publicado por Kimi para el SDK de OpenAI. ^[13] La variable KIMI_MODEL_ID debe ser el id que obtengas de

GET /models

[17]

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": "Hola, preséntate brevemente."}
    ],
)

print(response)

Ejemplo con cURL: primero el ID, luego el chat

El primer paso recomendable es listar los modelos disponibles en tu cuenta de Moonshot/Kimi, porque este endpoint devuelve la lista junto con el campo id. ^[17]

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

Cuando elijas el id correcto de la respuesta, úsalo en la llamada a Chat Completions. La ruta completa /chat/completions y la estructura model + messages aparecen en la documentación de Kimi. ^[13][14]

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": "Escribe una presentación breve de Kimi K2.6."}
    ]
  }'

Cómo comprobar el saldo de la API

Si quieres revisar la cuenta antes de integrar, o sospechas que el problema está relacionado con facturación, Kimi documenta el endpoint de balance en /users/me/balance y sus ejemplos usan Bearer token. ^[15]

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

No mezcles IDs de Moonshot con los de pasarelas intermedias

Algunos proveedores intermedios publican sus propios IDs para Kimi K2.6. AIMLAPI usa el endpoint https://api.aimlapi.com/v1/chat/completions con el modelo moonshot/kimi-k2-6. ^[1] OpenRouter, por su parte, muestra el modelo moonshotai/kimi-k2.6 en su página de API. ^[5]

Esos identificadores tienen sentido cuando llamas a la pasarela correspondiente. Si vas contra el endpoint oficial https://api.moonshot.ai/v1/chat/completions, la opción con menos margen de error es consultar

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

[13]

[17]

Conclusión

La integración mínima y segura queda así: obtén tu API key, configura el SDK de OpenAI con

base_url = https://api.moonshot.ai/v1

[1]

[5]

[13]

[14]

[17]