Use Cursor con una API LLM gratuita
Cursor puede enviar solicitudes de chat a su propia clave de API de OpenAI. Esta guía muestra cómo conectar esa clave a modelos gratuitos mediante FreeLLMAPI. También explica los límites. Cursor enruta cada solicitud a través de sus propios servidores, y la función Tab siempre usa los modelos de Cursor.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Qué funciona y qué no funciona
Lea esta sección antes de empezar. El soporte de claves propias de Cursor es más limitado que en la mayoría de los otros editores.
| Función de Cursor | Con su propia clave | Fuente |
|---|---|---|
| Chat con un modelo estándar de estilo OpenAI | Sí. Cursor documenta las claves propias de OpenAI para modelos de chat estándar, sin razonamiento. | Página de ayuda de claves de API de Cursor |
| Autocompletado con Tab | No. Cursor indica que Tab sigue usando los modelos integrados de Cursor. | Página de ayuda de claves de API de Cursor |
| Modo agente y Composer | No confirmado. La documentación de Cursor solo menciona modelos de chat. Pruébelo con su plan antes de depender de ello. | No documentado |
| Solicitudes desde localhost | No. Cursor envía todas las solicitudes a través de sus servidores para construir el prompt, así que localhost en su ordenador no forma parte del recorrido. | Página de ayuda de claves de API de Cursor |
Los planes también son importantes. La página de precios de Cursor indica los modelos de terceros y las claves de API propias en los planes Premium, Super y Ultra. Indica que el plan Plus no tiene claves de API propias. Para el plan Free, la página indica que los modelos de terceros no están disponibles. Revise la página de precios de su plan antes de continuar.
localhost. Lea Cline, Roo Code y Kilo Code con una API gratuita.Paso 1: Instale FreeLLMAPI y haga que sea accesible
FreeLLMAPI es de código abierto y se ejecuta en su ordenador con Docker. Instálelo y, después, añada al menos dos claves de proveedores gratuitos en la página Keys.
Instalación en macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopie su clave unificada desde la página Keys. Después dé al gateway una dirección HTTPS pública, porque los servidores de Cursor no pueden acceder a su localhost. Use un túnel HTTPS de confianza o un servidor que usted controle. La guía de FreeLLMAPI para Cursor muestra estos pasos:
Imprima la guía de Cursor
npx freellmapi setup-cursorEste comando no escribe ningún archivo. Cursor no tiene un archivo de configuración para este ajuste, así que introduzca los valores en la configuración de Cursor.
Authorization, cree un token de URL que pueda revocar por separado en Keys, Agents. Revóquelo cuando deje de usarlo.Paso 2: Configure la clave y la URL base en Cursor
- Abra Cursor Settings.
- Abra Models.
- Busque el campo de la clave de API de OpenAI. Pegue su clave unificada de FreeLLMAPI. Haga clic en Save.
- Active la opción de reemplazo de la URL base de OpenAI. La guía de FreeLLMAPI llama a este ajuste Override OpenAI Base URL.
- Introduzca su dirección pública con
/v1al final, por ejemplohttps://<your-tunnel-host>/v1. - Seleccione un modelo en el selector de modelos y envíe un mensaje corto de chat.
La documentación de privacidad de Cursor menciona el reemplazo de la URL base compatible con OpenAI. Cursor no documenta los pasos exactos. Las etiquetas de su versión pueden ser distintas.
Para confirmar que las solicitudes llegan al gateway, abra el registro de solicitudes del panel de control. Cada respuesta también tiene un encabezado X-Routed-Via que muestra el proveedor y el modelo que respondieron.
Paso 3: Elija los modelos
Use el id de modelo auto para que el enrutador seleccione un modelo gratuito en cada solicitud. También puede usar un id del catálogo de GET /v1/models. El chat de Cursor envía contexto de archivos con cada mensaje, así que use modelos con una ventana de contexto amplia. La tabla muestra los modelos gratuitos con llamadas a herramientas y al menos 128K de contexto de hoy.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 solicitudes/min 1 req/min per model | Sí | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 solicitudes/min 50 solicitudes/día Shared rate limit | Sí | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 solicitudes/min 250 solicitudes/día 70,000 tokens/min ~6M | Sí | Sí |
Se muestran 10 de 109 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
Cursor documenta las claves propias de OpenAI para modelos de chat sin razonamiento. Los modelos de razonamiento pueden fallar con el reemplazo. Si un modelo falla, use auto o un modelo distinto de la tabla.
Límites de uso y conmutación por error
Cada nivel gratuito tiene límites por minuto y por día. FreeLLMAPI cuenta el uso de cada clave. Cuando un proveedor envía un error 429, el enrutador envía la solicitud al siguiente modelo de su cadena de respaldo. El chat continúa y usted no cambia la configuración de Cursor.
- Añada claves de cuatro o más proveedores. Más proveedores dan más solicitudes al día.
- Use
auto:fastpara preguntas cortas yauto:smartpara preguntas difíciles de código. - Abra un chat nuevo para cada tarea. Un historial más corto envía menos tokens.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
Cursor no puede conectarse a http://localhost:3001/v1 | Cursor envía las solicitudes desde sus servidores, no desde su ordenador | Use una dirección HTTPS pública para el gateway |
| No aparece la opción de clave propia | Su plan de Cursor no incluye claves de API propias | Consulte la tabla de planes en la página de precios de Cursor |
401 "Invalid API key" | La clave de Cursor no es su clave unificada de FreeLLMAPI | Copie de nuevo la clave unificada desde la página Keys |
| El autocompletado con Tab no usa el gateway | Cursor siempre usa sus propios modelos para Tab | Sin solución. Use Continue en VS Code para autocompletado gratuito |
| "Todos los modelos alcanzaron el límite tras N intentos" | Todas las claves de la cadena han alcanzado su límite | Añada claves de más proveedores o espere a que terminen los periodos de enfriamiento |
| Los modelos integrados dejan de funcionar | El reemplazo de la URL base sigue activo | Desactive el reemplazo |
Preguntas frecuentes
¿Puedo usar Cursor gratis con mi propia clave de API?
La página de precios de Cursor indica las claves de API propias en los planes Premium, Super y Ultra, y dice que el plan Plus no tiene claves propias. En un plan con claves propias, FreeLLMAPI proporciona modelos gratuitos al chat, así que la inferencia cuesta 0 USD.
¿Por qué Cursor no se conecta a localhost?
Cursor envía todas las solicitudes a través de sus propios servidores para construir el prompt. Esos servidores no pueden acceder a localhost en su ordenador, así que el gateway necesita una dirección HTTPS pública.
¿Funciona el autocompletado Tab de Cursor con una API personalizada?
No. La documentación de Cursor indica que las claves de API personalizadas solo funcionan con modelos de chat, y que el autocompletado con Tab sigue usando los modelos integrados de Cursor.
¿Cuál es el mejor modelo gratuito para Cursor?
Use auto, o un modelo con llamadas a herramientas y al menos 128K de contexto de la tabla de esta página. Cursor envía contexto de archivos con cada mensaje, así que una ventana de contexto amplia es importante.
¿Se envía mi código a Cursor cuando uso mi propia clave?
Sí. Cursor indica que las solicitudes pasan por sus servidores para construir el prompt final. Zero Data Retention no se aplica cuando usa sus propias claves.
Guías relacionadas
- Modelos de IA gratuitos en VS Code
- Cline, Roo Code y Kilo Code con una API gratuita
- Continue con una API gratuita de LLM
- Mejores API gratuitas de modelos para programar
- URL base gratuitas compatibles con OpenAI
Fuentes
- Cursor help: API keys (revisado 20 November 2026)
- Cursor docs: models and pricing (revisado 20 November 2026)
- Cursor docs: privacy and data governance (revisado 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (revisado 20 November 2026)
- FreeLLMAPI CLI generators (revisado 20 November 2026)