Clave de API de Cursor AI: Dónde colocar una clave personalizada
Una clave API de Cursor AI es cualquier clave que pegues en la configuración de modelos del editor, y puede provenir de cualquier proveedor compatible con OpenAI cuando el editor te permita cambiar la URL base. Esta guía muestra dónde van los campos, cómo probar el endpoint primero y qué verificar cuando falle.
Resumen
- Necesitas tres valores: URL base, clave de API y nombre del modelo (uncensored).
- Prueba el endpoint con curl antes de tocar la configuración del editor.
- La mayoría de los fallos se deben a una ruta incorrecta, un encabezado Bearer faltante o un nombre de modelo incorrecto.
- El crédito de prueba de $0,50 es suficiente para ejecutar una sesión de prueba real sin tarjeta.
La respuesta corta
Los editores de la familia Cursor necesitan tres valores para comunicarse con un proveedor personalizado: una URL base, una clave API y un nombre del modelo. Para este servicio son:
- URL base:
https://api.cursoraiapikey.com/v1 - Clave de API: la clave de la página de clave de API
- Nombre del modelo:
uncensored
Abre la configuración del editor y busca la sección de modelos. Cursor ha ofrecido un campo para una clave de API de OpenAI y una opción para anular la URL base de OpenAI, pero las etiquetas del menú cambian entre versiones, así que busca en la configuración "base URL" si no los encuentras. Pega la URL y la clave, añade un modelo personalizado llamado uncensored, luego usa el botón de verificar si tu versión tiene uno.
Este servicio es independiente de Cursor. Es una API alojada por separado y no reemplaza la cuenta o plan propios del editor. Solo estás apuntando el chat del editor a un servidor compatible con OpenAI diferente.
Dos tipos de claves, dos lugares diferentes
La gente usa la misma palabra para dos cosas no relacionadas, y mezclarlas es la razón más común por la que una configuración falla.
El inicio de sesión de la cuenta
El editor tiene su propio inicio de sesión. Eso te identifica ante el proveedor del editor y no tiene nada que ver con un proveedor de modelos. No pegas una clave de proveedor en la pantalla de inicio de sesión.
La clave del proveedor
Esta es una cadena secreta emitida por la empresa que ejecuta un modelo. La pegas en la configuración del modelo junto con una URL base, y el editor la envía en el encabezado Authorization: Bearer con cada petición. Una clave de este servicio solo funciona contra la URL base de este servicio, y una clave de otro proveedor no funcionará aquí.
Si llegaste aquí buscando una manera de obtener la clave propia del editor gratis, esta no es esa. Si quieres un modelo de texto económico detrás del panel de chat del editor, sigue leyendo. El mismo patrón funciona para cualquier editor que acepte un endpoint compatible con OpenAI, y el artículo sobre reemplazar una clave de Claude cubre el caso paralelo para configuraciones estilo Anthropic.
Prueba el endpoint antes de tocar el editor
Una prueba de dos minutos fuera del editor te dice si el problema es la clave o el editor. Crea una cuenta, reclama la prueba en la página de claves y ejecuta esto:
curl https://api.cursoraiapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ok."}]
}'Deberías recibir un cuerpo JSON con un array choices. Los encabezados de respuesta incluyen X-Balance-USD, que muestra lo que queda en tu crédito. La misma llamada en Python con el SDK oficial:
from openai import OpenAI
client = OpenAI(
base_url="https://api.cursoraiapikey.com/v1",
api_key="YOUR_KEY",
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)Si ambas llamadas funcionan, la clave está bien y cualquier error posterior proviene de la configuración del editor.
Paso a paso en el editor
- Regístrate con Google o con correo electrónico y contraseña, luego reclama el crédito de prueba de $0,50 en la página de clave de API. No necesita tarjeta y es válida por 7 días.
- Copia la clave. Trátala como una contraseña.
- En el editor, abre Configuración y ve a la sección Modelos. Los nombres difieren entre versiones, así que trata las etiquetas en esta lista como una guía.
- Pega la clave en el campo de clave de API de OpenAI.
- Activa la opción para anular la URL base de OpenAI e ingresa
https://api.cursoraiapikey.com/v1. Mantén el/v1y no añadas/chat/completions; el cliente añade el resto. - Añade un modelo personalizado con el nombre exacto
uncensored. - Selecciona ese modelo en el panel de chat y envía un mensaje corto.
Si tu versión empuja un paso de verificación y falla mientras curl funciona, verifica que no dejaste un espacio final en la clave y que la URL base no tiene un segundo /v1 al final.
Qué usará y qué no usará tu clave
Configurar un endpoint personalizado no necesariamente cambia todas las funciones. Los editores suelen ejecutar algunas funciones, como el completado en línea o la aplicación de un diff, en modelos que el proveedor aloja directamente, y esos pueden ignorar tu clave. Las solicitudes de chat y estilo agente son las que normalmente se envían al endpoint que configuras. La documentación del editor es la autoridad para tu versión, así que revísala antes de planificar en torno a una función específica.
Dos cosas más que vale la pena verificar:
- Ruta de solicitud. Dependiendo de la versión, las solicitudes pueden pasar por servidores ejecutados por el proveedor del editor antes de llegar a tu endpoint. Si es así, una URL base en tu propia computadora no funcionará, mientras que una URL pública como esta sí. Lee las notas de privacidad del editor para ver qué almacena.
- Alcance del modelo. Este servicio ejecuta un modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto lícito. Es solo texto. No genera imágenes, audio ni incrustaciones, así que las funciones que necesiten eso no funcionarán a través de él.
La ventana de contexto es de 100.000 tokens para prompt más finalización, lo cual es suficiente para la mayoría del trabajo de un solo archivo y para muchas tareas de múltiples archivos. Los volcados de repositorios muy grandes no cabrán.
Solución de errores comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| 401 no autorizado | Clave incorrecta o revocada, espacio extra, clave pegada en el campo equivocado | Regenera la clave en la página de claves y pégala de nuevo. La clave antigua deja de funcionar al instante. |
| 404 no encontrado | Falta la URL base /v1, o /v1/v1 está duplicada | Usa exactamente https://api.cursoraiapikey.com/v1. |
| Modelo no encontrado | Nombre de modelo personalizado escrito de forma diferente | El nombre es uncensored, todo en minúsculas. |
429 con concurrency | Demasiadas peticiones a la vez; las claves de prueba permiten 2 | Espera a que las peticiones en curso terminen o pasa a una clave completa, que permite 8. |
429 con rate_limited | Se superó el límite por minuto; 60 en la prueba, 300 con una clave completa | Reduce la velocidad; los bucles de agentes pueden generar picos. |
429 con Retry-After: 5 | Sobrecarga temporal | Reintenta después de cinco segundos. |
Los modos de agente pueden disparar varias peticiones a la vez, y una respuesta en streaming mantiene su espacio hasta que termina la transmisión. Con una clave de prueba, es fácil alcanzar el límite de concurrencia. Esto es normal y no es un fallo de la clave.
Cuánto cuesta una petición
La facturación es de pago por uso a $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida, descontados del crédito prepago. Las peticiones fallidas o rechazadas no se cobran. Una vuelta típica de chat en un editor envía el archivo abierto y un historial, digamos 20.000 tokens de entrada, y recibe 1.500 tokens de salida:
- Entrada: 20.000 x $0,15 / 1.000.000 = $0,0030
- Salida: 1.500 x $0,50 / 1.000.000 = $0,00075
- Total: $0,00375, un poco menos de medio centavo
El crédito de prueba de $0,50 cubre por tanto unas 133 vueltas de ese tamaño. Eso es suficiente para una tarde de pruebas reales. Cuando decidas seguir adelante, las recargas van de $20 a $500 en cantidades enteras, con un bono del 5% desde $50, del 10% desde $100 y del 15% desde $200, pagados en cripto (USDT en TRC20 o USDC en Base). El crédito no caduca. La página de precios tiene la tabla completa y la documentación lista todos los parámetros compatibles.
