cursorapikey.com/Guía
Cómo usar las claves de API de Cursor con un endpoint personalizado
Así es cómo usar la configuración de la API de Cursor con tu propio endpoint: pega una clave, sobrescribe la URL base de OpenAI y añade el nombre del modelo uncensored. Los pasos siguientes toman unos cinco minutos e incluyen una comprobación con curl que puedes ejecutar primero.
Actualizado

Puntos clave
- Cursor te permite sobrescribir la URL base y la clave de OpenAI, de modo que cualquier endpoint compatible con OpenAI puede servir las peticiones.
- Usa la URL base https://api.cursorapikey.com/v1 y el ID de modelo
uncensored. - Prueba la clave con curl antes de tocar el editor, así sabrás de qué lado viene un fallo.
- Un prompt de 20 000 tokens con una respuesta de 1 000 tokens cuesta $0,0035.
De qué trata esta guía
Las personas que buscan cómo usar la API de Cursor generalmente se refieren a una de dos cosas. O bien quieren llamar a algún servicio de Cursor desde código, o bien quieren que el editor de Cursor envíe sus peticiones de modelo a un endpoint que elijan. Esta guía trata sobre el segundo caso. Este sitio es una API alojada independiente que habla el protocolo de finalización de chat de OpenAI, por lo que Cursor puede hablar con él de la misma manera que habla con cualquier servidor estilo OpenAI.
El modelo detrás de esto es un único modelo de pesos abiertos, ejecutado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito. No es un modelo oficial de Cursor, ni es un enrutador entre proveedores. Solo maneja texto. Para programación, esto suele ser suficiente: envías código e instrucciones, recibes código y explicaciones.
Necesitas tres cosas: una clave de API, la URL base https://api.cursorapikey.com/v1 y el ID de modelo uncensored. Todo lo demás es cuestión de encontrar los campos correctos en el editor.
Paso 1: obtener una clave y comprobarla con curl
Regístrate con Google o con correo electrónico y contraseña, luego abre la página de la clave de API. Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un clic. No requiere tarjeta y permanece válido por 7 días. La clave de prueba está limitada a 2 peticiones simultáneas y 60 peticiones por minuto, lo cual es suficiente para una primera sesión en el editor.
Antes de abrir Cursor, confirma que la clave funciona. Ejecuta esto en una terminal, con tu clave en una variable de entorno:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
La primera llamada lista el modelo. La segunda devuelve una finalización de chat normal. Si ambas tienen éxito, cualquier fallo posterior en el editor es un problema de configuración y no de clave. Esta separación ahorra muchas conjeturas.
Paso 2: configurar la URL base y la clave en Cursor
Abre la configuración de Cursor y ve a la sección de modelos. Los nombres del menú y el diseño cambian entre versiones, así que trata las etiquetas siguientes como un mapa y consulta la documentación propia de Cursor si algo ha cambiado.
- Encuentra el campo para una clave de API de OpenAI y pega tu clave de este sitio.
- Habilita la opción para sobrescribir la URL base de OpenAI e ingresa
https://api.cursorapikey.com/v1. Mantén el/v1al final y no añadas/chat/completions; la aplicación cliente añade la ruta ella misma. - Añade un modelo personalizado y escribe
uncensoredexactamente, en minúsculas. - Usa el botón de verificar o guardar si el editor lo ofrece, luego selecciona el nuevo modelo en el panel de chat.
Envía un mensaje corto como "explica esta función" con un archivo abierto. Una respuesta en streaming significa que la ruta funciona de extremo a extremo. Cursor envía la petición, el endpoint transmite tokens de vuelta mediante SSE y el editor los renderiza a medida que llegan.
Dos advertencias. Algunas funciones del editor, como la autocompletación en línea, pueden ejecutarse en modelos que controla Cursor y pueden ignorar tu clave, así que verifica qué funciones utilizan realmente el modelo personalizado. Y dado que Cursor puede enrutar el tráfico con clave personalizada a través de sus propios servidores, lee su documentación actual si necesitas saber exactamente por dónde viaja tu código. El inicio rápido de este sitio enumera la parte de la API del contrato.
Prueba el mismo endpoint desde código
La forma más fácil de aislar un problema es llamar al endpoint con el SDK oficial de OpenAI. Si eso funciona, el endpoint está bien y cualquier problema restante está en la configuración del editor.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Lo mismo en Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
Las respuestas en streaming incluyen el uso al final, así que puedes registrar exactamente cuántos tokens usó una petición. Cada respuesta también incluye un encabezado X-Balance-USD con tu crédito restante y un X-Request-Id para reportar si algo falla.
Qué funciona en un flujo de trabajo de programación
La API admite streaming, modo JSON y llamadas a funciones (tools, tool_choice, streaming de tool_calls y resultados como role: "tool"). Se pasan parámetros como temperature, top_p, stop, seed y penalizaciones. La ventana de contexto es de 100 000 tokens, compartida entre prompt y completado, y max_tokens es opcional.
Esos 100 000 tokens son un presupuesto generoso para código. Un archivo fuente de unos pocos cientos de líneas son unos pocos miles de tokens, así que puedes incluir varios archivos más una instrucción larga y aún dejar espacio para la respuesta. El cuerpo máximo de la petición es de 8 MB, lo cual no alcanzarás con texto.
Algunos hábitos que hacen agradable un modelo personalizado en un editor:
- Mantén un valor bajo de
temperaturepara editar código. Valores cerca de 0,2 dan salida más estable; súbelo solo para lluvia de ideas. - Adjunta solo los archivos que importan. Cada token que envías se cobra como entrada, y toda la conversación se reenvía en cada turno.
- Pide diffs o la función cambiada, no el archivo completo, cuando el archivo sea largo. Los tokens de salida cuestan más que los tokens de entrada.
- Usa el modelo para tareas donde los rechazos estorban, como escribir pruebas de concepto de exploits para tu propio laboratorio, analizar muestras de malware que estás autorizado a estudiar, o generar datos de prueba que imiten contenido real desagradable. Todo debe ser lícito.
El límite estricto que vale la pena repetir: sin contenido sexual que involucre menores de edad, bajo ningún planteamiento.
Corrección de errores comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| 401 o "clave inválida" | Clave pegada con un espacio, o una clave antigua | Vuelve a copiar desde la página de claves; prueba con curl |
| 404 o "modelo no encontrado" | Nombre del modelo escrito de forma diferente | Usa uncensored, en minúsculas y sin sufijo |
| 404 en la ruta | La URL base incluye /chat/completions | Termina la URL base en /v1 |
429 con concurrency | Demasiadas peticiones a la vez | Espera a que terminen los streams; una clave completa permite 8, una clave de prueba 2 |
429 con rate_limited | Más de 300 peticiones por minuto (60 en la prueba) | Ralentiza o reintenta después de una pausa |
429 con Retry-After: 5 | Sobrecarga temporal | Reintenta después de cinco segundos |
Una petición en streaming mantiene su espacio de concurrencia hasta que termina el stream. Si inicias varios chats en Cursor y los dejas generando, puedes alcanzar el límite de concurrencia en una clave de prueba rápidamente. Las peticiones fallidas o rechazadas no se cobran, así que reintentar no cuesta nada extra.
Cuánto cuesta una sesión de programación
La tarifa es de $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, pagados con crédito prepago sin suscripción. Una petición típica del editor tiene un prompt grande (tus archivos) y una respuesta corta. Toma 20 000 tokens de entrada y 1 000 tokens de salida:
- Entrada: 20.000 x $0,15 / 1.000.000 = $0,0030
- Salida: 1.000 x $0,50 / 1.000.000 = $0,0005
- Total: $0,0035 por petición
Con 100 peticiones en un día laboral eso son $0,35. El crédito de prueba de $0,50 cubre aproximadamente 140 peticiones de este tipo. Después de la prueba puedes recargar cualquier cantidad entera desde $20 hasta $500, con +5% de crédito bonus desde $50, +10% desde $100 y +15% desde $200. Paga con cripto (USDT en TRC20, USDC en Base). El crédito no caduca, así que una recarga que uses lentamente no se desperdicia. La página de precios tiene la tabla completa, y la página en la alternativa de Cursor y Copilot explica dónde encaja esto junto a editores de suscripción.
Los prompts no se utilizan para entrenamiento.
Más guías
Preguntas y respuestas
¿Funciona con el agente de Cursor y las llamadas a funciones?
La API admite llamadas a funciones con herramientas, tool_choice y tool_calls en streaming. Si una función concreta de Cursor usa tu modelo personalizado depende del editor, así que prueba cada función después de la configuración.
¿Qué nombre de modelo debo ingresar?
Ingresa uncensored, en minúsculas. Es el único ID de modelo y GET /v1/models lo lista.
¿Es esta la API oficial de Cursor?
No. Es una API independiente compatible con OpenAI detrás de un único modelo de pesos abiertos. Cursor simplemente te permite apuntar su configuración de OpenAI a un endpoint diferente.
¿Necesito una tarjeta para probarlo?
No. El crédito de prueba de $0,50 se reclama con un clic en la página de la clave de API después de iniciar sesión, no requiere tarjeta y es válido durante 7 días.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.