kimiapikey.comGuía
Usa una clave de API estilo Kimi en Cursor: Guía de configuración
Cursor puede comunicarse con cualquier endpoint compatible con OpenAI, por lo que conectarlo a esta API requiere cuatro campos y unos dos minutos. Esta guía cubre los valores exactos, una prueba que demuestra que la clave funciona y los errores que probablemente encuentres.
Actualizado

Puntos clave
- Cursor necesita tres valores: tu clave, la URL base https://api.kimiapikey.com/v1 y el nombre del modelo
uncensored. - Prueba la clave con curl primero, así es fácil distinguir un problema de Cursor de uno de la API.
- Los prompts grandes de estilo agente consumen muchos tokens de entrada: $0,15 por cada 1M de entrada y $0,50 por cada 1M de salida.
- La clave de prueba permite 2 peticiones simultáneas, lo que el agente de Cursor puede exceder. Una clave completa permite 8.
La respuesta corta
Si buscas cómo usar la clave de API de kimi en cursor, lo primero que debes saber es que una clave emitida por otro proveedor solo funciona con su propio endpoint. La clave de este sitio funciona con el endpoint de este sitio, y Cursor la acepta porque el endpoint usa el formato de chat completions de OpenAI. Pegas la clave, señalas Cursor a una URL base diferente y agregas un nombre de modelo personalizado.
La configuración completa en orden:
- Crea una cuenta y copia tu clave desde la página de clave de API.
- Abre Cursor, ve a Configuración, luego a Modelos.
- Pega la clave en el campo de clave de API de OpenAI.
- Activa la anulación de URL base e ingresa
https://api.kimiapikey.com/v1. - Agrega un modelo personalizado llamado
uncensoredy selecciónalo en el chat.
El resto de este artículo explica cada paso, te da una forma de probar la conexión fuera del editor y enumera lo que suele salir mal.
Lo que es y no es esta clave
Este sitio vende acceso a un único modelo de pesos abiertos, ejecutado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto legal. No es la API oficial de Moonshot, Kimi ni ningún otro proveedor, ni es un enrutador que reenvía tu petición al modelo de otro. El nombre del sitio refleja lo que la gente busca, no quién ejecuta el servicio. Si ya tienes una clave de otro proveedor, sigue usándola con su endpoint. Las dos claves no son intercambiables.
Lo que obtienes es una API estilo OpenAI pura: POST /v1/chat/completions y GET /v1/models, autenticación con token Bearer, una ventana de contexto de 100.000 tokens, streaming, llamadas a funciones y modo JSON. Solo texto. No hay generación de imágenes, ni embeddings ni ajuste fino, lo cual importa en un editor porque las funciones de Cursor que dependen de eso no usarán este endpoint. La explicación de la clave de API de Kimi entra en más detalle sobre el nombre y las alternativas.
Para programar, "uncensored" tiene un significado práctico. El modelo no se detendrá a mitad de una tarea porque un nombre de variable o un fixture de prueba parezca sensible. Herramientas de seguridad para sistemas que posees, analizadores de registros con cadenas feas, scrapers, generadores de ficción y conjuntos de pruebas de moderación son el tipo de trabajo que provoca rechazos en otros lugares. El límite estricto se mantiene: sin contenido sexual que involucre menores de edad, siempre.
Configuración paso a paso en Cursor
1. Obtén la clave y el crédito de prueba
Regístrate con Google o con un correo y contraseña. En la página de clave de API puedes reclamar $0,50 de crédito de prueba con un solo clic. No requiere tarjeta, dura 7 días y es por persona. Eso es suficiente para unos pocos cientos de peticiones de chat normales, así que puedes terminar esta guía completa sin pagar nada.
2. Abre la configuración de modelos
En Cursor, abre Configuración y busca la sección Modelos. Las etiquetas del menú cambian entre versiones, así que busca un campo con nombre para una clave de API de OpenAI y un interruptor o campo con nombre para anular la URL base de OpenAI. Esas son las dos configuraciones importantes.
3. Rellena los tres valores
| Campo de Cursor | Valor |
|---|---|
| Clave de API de OpenAI | Tu clave del panel |
| Anular URL base de OpenAI | https://api.kimiapikey.com/v1 |
| Nombre de modelo personalizado | uncensored |
Ingresa la URL base exactamente como se muestra. Termina en /v1, sin barra final y sin /chat/completions, porque el cliente añade la ruta él mismo. Una URL pegada con la ruta completa produce un 404, y el mensaje de error rara vez dice por qué.
4. Selecciona el modelo y envía un mensaje
Abre el panel de chat, selecciona uncensored de la lista de modelos y pide algo pequeño, como "escribe una función que analice fechas ISO". Si una respuesta hace streaming, has terminado. Si Cursor muestra un error, no cambies la configuración al azar. Ve a la siguiente sección y prueba el endpoint directamente.
5. Conoce el efecto secundario de la anulación
La sobrescritura de la URL base suele aplicarse a todos los modelos compatibles con OpenAI que uses en Cursor, no solo al personalizado. Si vuelves a un modelo estándar de OpenAI más tarde, desactiva primero la sobrescritura, o tu petición se enviará a este endpoint con un nombre de modelo que no ofrece.
Prueba la clave antes de culpar al editor
Dos minutos con una terminal ahorran una hora de conjeturas. Esta petición hace lo que hace Cursor: envía una completión de chat con un token Bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Un cuerpo JSON con una matriz choices significa que la clave, la URL y el nombre del modelo son correctos. Verifica también los encabezados de respuesta. X-Balance-USD muestra tu crédito restante y X-Request-Id vale la pena guardarlo si alguna vez necesitas rastrear una petición.
La misma comprobación en Python con el SDK oficial de OpenAI:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
También puedes listar modelos con GET /v1/models. Cursor y clientes similares a veces lo llaman cuando presionas un botón de verificación, así que una llamada a modelos que funciona es una buena señal. Si curl funciona y Cursor no, el problema está en la configuración del editor, y la tabla de errores a continuación cubre los habituales.
Qué cambia cuando el modelo escribe código en tu editor
Chatear en un panel lateral es barato. Una pregunta corta con unos pocos cientos de tokens de contexto cuesta una fracción de centavo. Las funciones del editor que adjuntan archivos, resultados de búsqueda e historial de conversación cuestan más porque cada petición lleva todo de nuevo. El modelo tiene una ventana de 100.000 tokens compartida entre prompt y respuesta, y Cursor la llenará con gusto si adjuntas una carpeta grande.
Aquí hay un cálculo real. Digamos que una petición lleva 40.000 tokens de entrada y el modelo escribe 1.500 tokens de respuesta:
- Entrada: 40.000 / 1.000.000 x $0,15 = $0,006
- Salida: 1.500 / 1.000.000 x $0,50 = $0,00075
- Total: $0,00675 por petición, así que 100 de esas peticiones cuestan $0,675
Eso está muy por debajo de un dólar para una tarde intensa, pero el lado de entrada domina, así que el hábito que ahorra dinero es adjuntar menos archivos, no hacer preguntas más cortas. Inicia un chat nuevo cuando cambie el tema, porque el historial antiguo se paga de nuevo en cada turno.
Las llamadas a funciones son compatibles con la API, que es en lo que se basan las funciones de editor estilo agente. El modelo decide llamar a una herramienta, tu cliente la ejecuta y devuelve el resultado como un mensaje role: "tool". Qué tan bien cualquier modelo conduce un agente de varios pasos depende del modelo, así que pruébalo en una tarea pequeña antes de entregarle una refactorización. Un modelo de pesos abiertos detrás de la API significa que obtienes un comportamiento, no un menú para elegir.
Las funciones de Cursor que se ejecutan en los propios modelos de Cursor, como su autocompletado de pestañas, generalmente no se cambian con una clave personalizada. Consulta la documentación actual de Cursor para ver qué funciones aceptan un endpoint estilo OpenAI personalizado, ya que esa lista cambia entre versiones.
Errores comunes y cómo solucionarlos
| Síntoma | Causa probable | Solución |
|---|---|---|
| 404 o "no encontrado" | La URL base incluye la ruta del endpoint, o le falta /v1 | Usa exactamente https://api.kimiapikey.com/v1 |
| 401 no autorizado | Espacio extra o salto de línea en la clave pegada, o una clave antigua | Vuelve a copiar la clave desde el panel de control y pégala de nuevo |
| Modelo no encontrado | Nombre del modelo escrito de forma diferente | Usa uncensored, en minúsculas, nada más |
429 con código concurrency | Demasiadas peticiones a la vez para tu clave | Espera a que terminen las peticiones en curso o usa una clave completa (8 concurrentes) |
429 con código rate_limited | Más de la cuota por minuto | Ralentiza; las claves de prueba permiten 60 por minuto, las completas 300 |
429 con un encabezado Retry-After: 5 | Sobrecarga temporal | Reintenta después de cinco segundos |
| El botón de verificación falla, curl funciona | El editor prueba con un nombre de modelo que conoce | Salta el paso de verificación y envía un mensaje de chat real |
El error de concurrencia merece una nota porque sorprende a la gente con la clave de prueba. La prueba permite 2 peticiones simultáneas, y un agente que inicia varias operaciones en paralelo puede superar ese límite sin que hagas nada. Una respuesta en streaming también mantiene su espacio hasta que termina el flujo, así que una respuesta larga mantiene un espacio ocupado todo el tiempo. Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto, lo cual es cómodo para un desarrollador.
Las peticiones fallidas y rechazadas no se cobran, así que reintentar tras un error no cuesta nada extra. Puedes leer los límites completos en la página de documentación.
Pagar por ello una vez que se agote la prueba
No hay suscripción. Recargas el crédito prepago con cualquier cantidad entera desde $20 hasta $500, y las peticiones lo consumen a $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida. El crédito no caduca, así que un mes sin programar no cuesta nada. Las recargas de $50 o más tienen un bono: +5% desde $50, +10% desde $100 y +15% desde $200. Puedes pagar con cripto (USDT en TRC20, USDC en Base). La página de precios tiene los números actuales en un solo lugar.
Usando la petición de 40.000 de entrada y 1.500 de salida de antes, una recarga de $20 cubre aproximadamente 2.960 de esas peticiones ($20 / $0,00675). La mayoría de las peticiones del editor son más pequeñas, así que la cifra real es mayor. Tus prompts no se usan para entrenamiento, lo cual importa cuando el código que pegas pertenece a un cliente.
Cuando termines la configuración, una primera tarea sensata es una pequeña que puedas revisar rápidamente: una prueba unitaria para una función existente, una expresión regular con un comentario largo, o una reescritura de un archivo ruidoso. Si los resultados se adaptan a tu flujo de trabajo, añade crédito. Si no, has gastado unos céntimos de crédito de prueba para averiguarlo.
Más guías
- Precios de la clave de API de Kimi: cuánto cuesta esta alternativa
- Integración de la clave de API de Kimi con SDKs de OpenAI y LangChain
- Clave de API de Kimi: cómo funciona y cuáles son las alternativas
Preguntas frecuentes
¿Es el modelo el mismo que el Kimi oficial de Moonshot?
No, alojamos un modelo de pesos abiertos que está ajustado para ser sin censura. No es GPT, Claude, Gemini, Grok, DeepSeek ni ningún otro modelo de proveedor. Es un modelo distinto ejecutado en nuestros propios servidores.
¿Entrenan con mis datos?
No. Tus prompts y completados no se utilizan para el entrenamiento. Valoramos la privacidad y la transparencia, por lo que tus datos siguen siendo tuyos.
¿Cuáles son los límites de peticiones?
Estás limitado a 300 peticiones por minuto por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Estos límites están diseñados para garantizar un rendimiento estable para todos los usuarios.
¿Cuál es la política de contenido?
El modelo es sin censura respecto a temas adultos, controversiales y creativos. Sin embargo, bloqueamos contenido sexual que involucre menores. Este es un límite estricto que siempre se aplica, independientemente de tu nivel de suscripción.
Preguntas y respuestas
¿Puedo poner una clave de Moonshot o Kimi en Cursor con esta URL base?
No. Una clave solo funciona con el endpoint del proveedor que la emitió. Usa la clave de tu panel aquí, o mantén la otra clave con la URL de su propio proveedor.
¿Qué nombre de modelo introduzco en Cursor?
Introduce uncensored, en minúsculas. Es el único ID de modelo que sirve esta API, y un nombre diferente devuelve un error de modelo no encontrado.
¿Funciona con el modo agente de Cursor?
La API admite llamadas a funciones, que necesitan las características del agente. Qué tan fiablemente el modelo completa tareas largas de varios pasos varía, así que pruébalo en una tarea pequeña antes que en una grande.
¿Por qué obtengo un error 429 con la clave de prueba?
La clave de prueba permite 2 peticiones simultáneas y 60 por minuto. Una clave completa permite 8 simultáneas y 300 por minuto, y un encabezado Retry-After: 5 significa una sobrecarga breve que puedes reintentar.
¿Se usa mi código para entrenamiento?
No. Los prompts enviados a la API no se utilizan para entrenamiento.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.