Authorization: Bearer ...base_url a https://api.moonshot.ai/v1. /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. 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. Este ejemplo usa el base_url publicado por Kimi para el SDK de OpenAI. La variable
KIMI_MODEL_ID debe ser el id que obtengas de 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": "Hola, preséntate brevemente."}
],
)
print(response)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.
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.
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."}
]
}'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.
curl -sS https://api.moonshot.ai/v1/users/me/balance \
-H "Authorization: Bearer $MOONSHOT_API_KEY"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. OpenRouter, por su parte, muestra el modelo
moonshotai/kimi-k2.6 en su página de API.
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/modelsid que Moonshot devuelva para tu cuenta.
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/models para confirmar el ID de Kimi K2.6 y envía la solicitud a /chat/completions con model y messages. Con ese flujo sigues la documentación compatible con OpenAI de Kimi y evitas el error clásico: pegar en Moonshot un ID que pertenece a AIMLAPI u OpenRouter.