Así puedes usar Kimi K3.1 Pro de cuatro formas: chatea con él en la web o la aplicación móvil de Kimi, llama a kimi-k3.1-pro a través de la API compatible con OpenAI en https://api.moonshot.ai/v1, ejecútalo dentro del CLI de Kimi Code con una membresía de pago, o apunta Codex, Claude Code u OpenCode a los endpoints de Moonshot. La API se desbloquea tras una recarga de $1 y cuesta $2 por millón de tokens de entrada y $10 por millón de tokens de salida.
Moonshot AI lanzó Kimi K3.1 Pro el 23 de octubre de 2026. Es una versión post-entrenada de Kimi K3 con el mismo diseño MoE de 2,8 billones de parámetros (unos 104B activos), una ventana de contexto de 1.048.576 tokens y un modo de pensamiento que siempre está activado. Si primero quieres los antecedentes, lee qué es Kimi K3.1 Pro. Si no quieres gastar nada, nuestra guía para usar Kimi K3.1 Pro gratis cubre las rutas de $0. Todos los datos que aparecen a continuación provienen del anuncio de Moonshot, la guía de inicio rápido de la API y la página de precios, consultados el 24 de octubre de 2026.
¿Qué ruta de Kimi K3.1 Pro deberías elegir?
Elige según lo que estés construyendo. El chat es adecuado para preguntas rápidas, la API para aplicaciones, Kimi Code para miembros que quieren un agente sin ninguna clave que gestionar, y tu propio agente para equipos que ya viven en Codex o Claude Code.
| Ruta | Ideal para | Coste inicial | Qué necesitas |
|---|---|---|---|
| Chat web/app de Kimi | Probar prompts, documentos, imágenes | Cuenta gratuita | Iniciar sesión |
| API de Kimi | Aplicaciones, scripts, pipelines | Recarga mínima de $1 | Clave de API |
| CLI de Kimi Code | Agente de programación en terminal | Membresía de pago (Plus y superiores) | /login |
| Codex, Claude Code, OpenCode | Tu flujo de trabajo de agente actual | Recarga mínima de $1 | Clave de API + configuración |
Usa Kimi K3.1 Pro en las aplicaciones web y móviles de Kimi
Las aplicaciones de chat son la vía más rápida. Abre la aplicación web de Kimi o la app para iOS, Android o HarmonyOS, inicia sesión con una cuenta gratuita y K3.1 Pro ya aparece como el modelo predeterminado en el compositor, con el esfuerzo de razonamiento establecido en High.
Antes de iniciar sesión, el compositor también muestra K2.8 Preview e Instant. Enviar un prompt requiere una cuenta. Moonshot no publica la cuota de mensajes de K3.1 Pro del plan gratuito [VERIFY], así que trata el chat como un banco de pruebas, no como un canal de producción.
Kimi Work para escritorio 3.1.0 y posteriores (Windows y Mac con Apple silicon) también ejecuta el modelo. En Kimi Business y Enterprise, un administrador tiene que activarlo, porque viene desactivado de forma predeterminada en el lanzamiento.
API de Kimi K3.1 Pro: primera llamada en Python y cURL
La API de Kimi K3.1 Pro es compatible con OpenAI, por lo que el SDK estándar openai funciona cambiando la URL base. La configuración consta de tres pasos:
- Recarga al menos $1. K3.1 Pro es un modelo insignia y solo se desbloquea tras una recarga correcta.
- Crea una clave en la consola de claves de API y expórtala como
MOONSHOT_API_KEY. - Llama al modelo
kimi-k3.1-pro(okimi-k3.1-pro-highspeed) enhttps://api.moonshot.ai/v1.
Este es el ejemplo oficial de Python de Moonshot:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
model="kimi-k3.1-pro",
reasoning_effort="high",
messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)
La misma llamada en cURL:
curl https://api.moonshot.ai/v1/chat/completions \
--header "Authorization: Bearer $MOONSHOT_API_KEY" \
--header "Content-Type: application/json" \
--data '{"model": "kimi-k3.1-pro","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'
El modelo acepta texto, imágenes y vídeo como entrada (la guía de inicio rápido muestra las partes image_url y video_url) y devuelve texto. También puedes probar prompts en el Playground antes de escribir código. Para ver patrones de la era K3 que siguen siendo válidos, consulta nuestra guía de la API de Kimi K3.
Esfuerzo de razonamiento de Kimi K3.1 Pro: low, high o max
reasoning_effort es un campo de nivel superior de la solicitud que establece cuánto piensa el modelo antes de responder. Acepta "low", "high" y "max", y el valor predeterminado es "max". El pensamiento no se puede desactivar. No existe un nivel "medium".
| Valor | Cuándo usarlo |
|---|---|
low |
Clasificación, extracción, respuestas cortas donde la latencia importa |
high |
La mayoría de las tareas de programación y análisis |
max (predeterminado) |
Tareas de largo horizonte, depuración difícil, planes de varios pasos |
La guía de esfuerzo de razonamiento de Moonshot contiene la referencia completa. Como pagas los tokens de salida a $10 por millón, bajar de max a low en las llamadas sencillas es el ahorro más fácil que encontrarás. Omite temperature y top_p: la guía de inicio rápido los indica como fijos en 1.0 y 0.95.
Transmite el razonamiento, conserva el estado multiturno, recibe JSON de vuelta
Hay tres comportamientos de la API que suelen causar problemas, y cada uno tiene una regla sencilla.
Streaming. Una respuesta en streaming envía deltas separados de reasoning_content y content. Muestra o registra el primero, renderiza el segundo:
stream = client.chat.completions.create(
model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
delta = chunk.choices[0].delta
thinking = getattr(delta, "reasoning_content", None)
if thinking:
print(thinking, end="")
if delta.content:
print(delta.content, end="")
Multiturno y llamadas a herramientas. Devuelve el mensaje completo del asistente, no solo su content. La documentación de Moonshot es explícita al respecto, y esto importa sobre todo cuando hay llamadas a herramientas de por medio:
messages.append(completion.choices[0].message) # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})
Se admite tool_choice: "required" cuando necesitas que el modelo llame a una herramienta. El modo parcial también funciona: termina tus mensajes con un mensaje del asistente que tenga "partial": true y el modelo lo continuará.
Salida estructurada. Pasa response_format con el tipo json_schema y strict: true, y luego analiza únicamente message.content. Nunca analices el texto del razonamiento.
Kimi Code K3.1 Pro: la ruta de la membresía
Kimi Code es el agente de programación de terminal de Moonshot, y es la ruta en la que no hay clave de API. En su lugar, inicias sesión con tu cuenta de Kimi. Es un beneficio de la membresía, por lo que el plan gratuito Adagio no lo incluye.
Instálalo e inicia sesión:
# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi
Dentro de la sesión, ejecuta /login y luego /model para elegir K3.1 Pro. Los dos ID se corresponden con los niveles de plan:
k3.1-pro: Moderato (Plus) y superiores. Allegretto (Pro) y superiores desbloquean hasta el contexto de 1M.k3.1-pro-highspeed: Allegretto (Pro) y superiores, consumiendo aproximadamente 2x de cuota.
Según los precios de las membresías, Plus cuesta $15 al mes con facturación anual ($19 mensual) y Pro cuesta $31 al año ($39 mensuales). La documentación de Kimi Code cubre los comandos, y nuestro recorrido por el CLI de Kimi Code profundiza en el uso diario.
Kimi K3.1 Pro en Codex
Codex se comunica con Kimi a través de la API de Responses, y Moonshot publica una guía oficial de Codex. Añade esto a ~/.codex/config.toml:
model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576
[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"
Fíjate en el nombre de la variable de entorno: Codex lee KIMI_API_KEY, no MOONSHOT_API_KEY. Exporta tu clave de Moonshot con ese nombre y luego inicia codex como de costumbre.
Kimi K3.1 Pro en Claude Code
Moonshot gestiona un endpoint de Messages compatible con Anthropic en https://api.moonshot.ai/anthropic, por lo que Claude Code funciona sin proxy. Coloca las variables en el bloque env de ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
"ANTHROPIC_MODEL": "kimi-k3[1m]"
}
}
El alias es intencionado. La página de solución de problemas de Moonshot indica que las llamadas directas a la API y Codex usan kimi-k3.1-pro, mientras que Claude Code usa el alias compatible kimi-k3[1m]. La guía de Claude Code también establece las demás variables del modelo, así que cópialas de ahí.
Un detalle a tener en cuenta: los valores obsoletos en el bloque env del archivo de configuración anulan las variables exportadas en el shell. Si Claude Code sigue llamando a un modelo antiguo, revisa ese archivo primero.
OpenCode
OpenCode no necesita ningún archivo de configuración. Ejecuta opencode auth login, selecciona «Moonshot AI», pega tu clave y luego elige K3.1 Pro entre los modelos de Moonshot AI. La guía de OpenCode de Moonshot se escribió para K3, así que confirma que el modelo aparece en tu lista [VERIFY].
Deja que tu agente pruebe la API de Kimi con Apidog CLI
Una vez que Codex o Claude Code se ejecuten sobre K3.1 Pro, pon esa misma sesión a trabajar en las pruebas de regresión de la propia API de Kimi. Tu agente escribe y ejecuta las comprobaciones; tú escribes un solo prompt. Apidog CLI le proporciona salida JSON estructurada y esquemas, para que no tenga que adivinar las formas de los payloads.
Instala el CLI, inicia sesión y añade la skill del agente:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install
Luego dale a tu agente un solo prompt:
In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.
El agente crea el entorno, lee el esquema, valida su payload, escribe el caso y lo ejecuta:
apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Los casos de prueba necesitan una categoría válida, y apidog test-case category --project <projectId> las lista. Un 200 con una respuesta no vacía también demuestra que la API aceptó reasoning_effort. Cambia a -r junit y la misma ejecución se integra en CI, como muestra nuestra guía de CI/CD de Apidog CLI. La configuración específica para agentes está en Apidog CLI en Codex y Apidog CLI en Claude Code. El plan gratuito de Apidog cubre hasta 4 usuarios.
Notas sobre el coste de Kimi K3.1 Pro
La API se paga según el uso, sin suscripción, y los precios no incluyen impuestos.
| Modelo | Entrada / 1M | Salida / 1M | Entrada en caché / 1M |
|---|---|---|---|
kimi-k3.1-pro |
$2.00 | $10.00 | $0.20 |
kimi-k3.1-pro-highspeed |
$4.00 | $20.00 | $0.20 |
kimi-k3 |
$3.00 | $15.00 | $0.30 |
K3.1 Pro es un tercio más barato que K3 tanto en entrada como en salida. El almacenamiento en caché es automático para prefijos repetidos, con un TTL predeterminado de 5 minutos, y los aciertos de caché se facturan a $0.20. Highspeed funciona entre 2 y 3 veces más rápido al doble de precio.
Tu recarga mínima de $1 compra unos 500K tokens de entrada o 100K tokens de salida. Cuando tus recargas acumuladas alcanzan los $5, obtienes un vale de $5, pero los vales no cuentan para la recarga acumulada, y no se especifica si se aplican a K3.1 Pro [VERIFY]. Una cuenta de $1 empieza en el nivel Tier0 según la página de límites: 1 solicitud concurrente, 3 RPM y 1,5M de tokens al día. El Tier1 con $10 acumulados eleva eso a 100 RPM.
Preguntas frecuentes
¿Kimi K3.1 Pro es de pesos abiertos?
Todavía no. Moonshot afirma que los pesos completos del modelo se publicarán antes del 4 de noviembre de 2026. No se ha indicado la licencia.
¿Cuál es la diferencia entre K3.1 Pro y K3.1 Pro Highspeed?
La misma familia de modelos, distinta velocidad y precio. Highspeed funciona entre 2 y 3 veces más rápido y cuesta $4/$20 por millón de tokens frente a $2/$10. En Kimi Code requiere el plan Pro y consume aproximadamente 2x de cuota.
¿Puedo desactivar el pensamiento en Kimi K3.1 Pro?
No. El pensamiento siempre está activado. Establece reasoning_effort en "low" para reducir los tokens de razonamiento y la latencia.
¿Por qué se rompe mi conversación multiturno?
Probablemente estés devolviendo solo el content del asistente. Añade el objeto completo del mensaje del asistente a tu historial, como exige la documentación de Moonshot para los chats multiturno y las llamadas a herramientas.
¿La API de Kimi es gratuita?
No. K3.1 Pro se desbloquea tras una recarga mínima de $1. El chat gratuito en la aplicación de Kimi es la opción de $0, cubierta en nuestra guía gratuita.
¿Kimi K3.1 Pro admite una ventana de contexto de 1M?
Sí. La API admite 1.048.576 tokens. En Kimi Code, el contexto completo de 1M requiere Allegretto (Pro) o superior.