Kimi K2 API: guía de integración, precios y Python (2026)
Pon en marcha la API de Kimi K2 de Moonshot: consigue la clave, llámala con curl y Python, compara precios directos vs. agregador (entrada desde $0.55/M), entiende el contexto de 256K, los límites y los errores comunes, y usa Kimi, GPT y Claude con una sola clave.
Kimi K2 es el modelo MoE insignia de Moonshot AI. Con una ventana de contexto larga y una buena relación precio-rendimiento, se ha convertido en una opción seria para equipos que crean agentes, herramientas de código y flujos con documentos largos. Esta guía va en orden: consigue la clave, envía la primera petición, calcula el coste real y entiende los límites. ¿Con prisa? Consigue crédito gratis en GetModel con un código de referido y usa Kimi, GPT y Claude con una sola clave.
Qué ofrece Kimi K2
Kimi K2 usa una arquitectura Mixture-of-Experts (MoE) —alrededor de 1T de parámetros totales y unos 32B activos por inferencia— buscando «capacidad de modelo grande al coste de la activación dispersa». Hay tres variantes principales; la API y el uso son idénticos, y se diferencian en nivel de capacidad y precio:
kimi-k2(original 0711) — la primera versión abierta, el precio más bajo, ideal para tareas generales sensibles al coste.kimi-k2.5— una mejora integral con descuento por acierto de caché, para tareas cotidianas de complejidad media.kimi-k2.6(la más reciente) — el nivel más potente hoy, el mejor en código y flujos de agentes, también con descuento por caché.
También hay derivados como kimi-k2-thinking (razonamiento más fuerte), kimi-k2-turbo (mayor velocidad) y kimi-k2.7-code, especializado en programación. Moonshot itera rápido, así que revisa la lista actual de modelos en la consola antes de construir. Todas las variantes traen una ventana de contexto de 256K tokens, suficiente para tragarse un manual entero o un buen trozo de un código base. Esa es su principal ventaja frente a muchos modelos de precio similar.
En cuanto a la interfaz, Kimi K2 es totalmente compatible con el formato Chat Completions de OpenAI (algunos canales exponen también un formato compatible con Anthropic), así que tu código actual con el SDK openai normalmente solo necesita cambiar dos campos.
Integración + código
Hay dos caminos. Directo (oficial) conviene si solo usas Kimi; agregador conviene si además usas GPT, Claude o Gemini y prefieres no gestionar varias claves y facturas.
Opción 1: directo con la plataforma Moonshot
- Regístrate en la plataforma abierta de Moonshot (en China,
platform.moonshot.cn); - Crea una clave en «gestión de API Keys»;
- Anota la URL base:
https://api.moonshot.ai/v1(en China,https://api.moonshot.cn/v1).
curl:
curl https://api.moonshot.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-d '{
"model": "kimi-k2.6",
"messages": [{"role": "user", "content": "Presenta Kimi K2 en una frase"}]
}'
Python (reutiliza el SDK openai; solo cambian base_url y model):
from openai import OpenAI
client = OpenAI(
api_key="tu-clave-Moonshot",
base_url="https://api.moonshot.ai/v1",
)
resp = client.chat.completions.create(
model="kimi-k2.6",
messages=[{"role": "user", "content": "Presenta Kimi K2 en una frase"}],
)
print(resp.choices[0].message.content)
Añade stream=True para streaming (el formato SSE coincide con OpenAI); las llamadas a herramientas usan el campo tools de OpenAI, sin adaptadores extra.
Opción 2: agregador (una clave para Kimi / GPT / Claude)
Si tu proyecto no es solo Kimi, una pasarela agregadora como GetModel ahorra mucho trabajo: una clave, un endpoint compatible con OpenAI, y cambias de modelo solo con el campo model —el saldo es compartido entre todos los modelos y la factura es única.
- Entra en la consola de GetModel y crea una clave (empieza por
sk-) en la página «API Tokens»; - Cambia la URL base a
https://getmodel.ai/v1; - Pon
model=kimi-k2; consulta variantes y capacidades en la página del modelo Kimi K2.
from openai import OpenAI
client = OpenAI(
api_key="sk-tu-clave-GetModel",
base_url="https://getmodel.ai/v1",
)
# Llamar a Kimi K2
resp = client.chat.completions.create(
model="kimi-k2",
messages=[{"role": "user", "content": "Hola, Kimi"}],
)
print(resp.choices[0].message.content)
# El mismo código: cambia model a gpt-5.2 o claude-sonnet-5 para cambiar de proveedor
La pasarela incluye conmutación entre canales (failover): si un upstream falla, redirige automáticamente —más estable en producción.
Precios: directo vs. agregador
Kimi K2 se cobra por token, los precios varían según la variante, y K2.5 / K2.6 admiten «acierto de caché»: un prefijo repetido (un system prompt largo, un documento fijo) que acierta en caché reduce el precio de entrada al 10–20% de la tarifa. A continuación, los precios de referencia por 1M de tokens (en USD; prevalece el precio en vivo del sitio oficial / la consola):
| Variante | Entrada / 1M | Salida / 1M | Entrada en caché / 1M |
|---|---|---|---|
kimi-k2 (original 0711) | $0.55 | $2.20 | — |
kimi-k2.5 | $0.60 | $3.00 | $0.10 |
kimi-k2.6 (la más reciente) | $0.95 | $4.00 | $0.16 |
Algunas notas:
- La K2 original tiene el precio unitario más bajo —la mejor opción para puro volumen cuando no necesitas capacidad máxima;
- La K2.6 tiene el precio más alto, pero la entrada en caché cuesta solo $0.16 —con prompts largos llamados repetidamente, el coste real puede ser mucho menor de lo que parece;
- Los precios oficiales y de reventa/agregador fluctúan, así que consulta el precio en vivo antes de lanzarte. Los precios en vivo de Kimi y otros modelos en GetModel están en la página de precios.
Crédito gratis: regístrate en GetModel con un código de referido de un socio o creador para obtener créditos de prueba, y funcionan con todos los modelos —úsalos para probar Kimi, GPT y Claude en paralelo antes de elegir el principal. La política de créditos de prueba propia de Moonshot es la que indique su sitio oficial en cada momento.
Longitud de contexto y límites
Contexto: toda la línea Kimi K2 ofrece un contexto de 256K tokens, ideal para preguntas sobre documentos largos, análisis de código de todo el repositorio y conversaciones largas de varios turnos. Recuerda que un contexto más largo aumenta tanto el consumo de tokens como la latencia por petición, así que en documentos largos combínalo con la caché para reutilizar la parte fija y ahorrar.
Límites: oficialmente, las cuentas se escalan por RPM (peticiones por minuto), TPM (tokens por minuto) y concurrencia. Las cuentas nuevas empiezan bajas y se amplían al recargar o crecer el uso. Al superarlos, la API devuelve 429 —en producción usa siempre backoff exponencial. Vía GetModel, los límites aplican por clave y grupo (visibles en la consola) y se suman a la conmutación entre canales, de modo que un upstream limitado se sortea automáticamente.
Errores comunes y solución
- 401 / fallo de autenticación: clave mal escrita, falta el prefijo
Bearer, o una clave de otro entorno. Comprueba que la cabeceraAuthorizationy elbase_urlse correspondan. - 429 / límite alcanzado: has superado el RPM/TPM o la concurrencia. Añade backoff exponencial, baja la concurrencia o sube el nivel de cuenta; vía GetModel, la conmutación entre canales lo sortea automáticamente.
- Longitud de contexto superada: una entrada de más de 256K tokens da error. Recorta o divide la entrada, o activa la caché para reutilizar un prefijo fijo.
- Tiempo de espera / conexión cortada: por entradas largas o una red inestable. Configura un
timeoutrazonable y reintenta; en producción, activa el reintento automático y el failover en la pasarela.
Preguntas frecuentes (FAQ)
- ¿Kimi K2 tiene crédito gratis? Sí. Moonshot da créditos de prueba a nuevos usuarios; registrarte vía GetModel también da créditos multimodelo —ideal para probar antes de comprar.
- ¿K2, K2.5 o K2.6? Para volumen barato,
kimi-k2; para uso cotidiano equilibrado,kimi-k2.5; para código/agentes/razonamiento complejo,kimi-k2.6, el más económico con caché en prompts largos. - ¿Admite llamadas a herramientas y streaming? Ambos. Las llamadas a herramientas usan el campo
toolsde OpenAI; el streaming usastream=True, con el mismo formato que OpenAI. - ¿Se puede llamar desde China? Sí —Moonshot ofrece el endpoint
api.moonshot.cn. Si además necesitas modelos de fuera como GPT o Claude, una pasarela agregadora lo cubre todo con una sola clave. - ¿Puedo mantener mi código actual de OpenAI? Sí. Kimi K2 es compatible con OpenAI Chat Completions; normalmente solo cambian
base_urlymodel.
Para usar Kimi, GPT, Claude y Gemini desde una sola base de código con una única clave y una sola factura, empieza en la consola de GetModel y arranca Kimi K2 con tus créditos de prueba.