Inicio / Guías / Use Cursor con una API LLM gratuita

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 CursorCon su propia claveFuente
Chat con un modelo estándar de estilo OpenAISí. 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 TabNo. Cursor indica que Tab sigue usando los modelos integrados de Cursor.Página de ayuda de claves de API de Cursor
Modo agente y ComposerNo 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 localhostNo. 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.

Nota: si quiere un agente de editor gratuito sin las reglas de un plan, use Cline, Roo Code o Kilo Code en VS Code. Estos se conectan directamente a 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 | bash

Copie 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-cursor

Este 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.

Seguridad: una URL pública permite que cualquiera que tenga su clave unificada use sus cuotas gratuitas. No comparta nunca la clave. Si su túnel no puede enviar un encabezado 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

  1. Abra Cursor Settings.
  2. Abra Models.
  3. Busque el campo de la clave de API de OpenAI. Pegue su clave unificada de FreeLLMAPI. Haga clic en Save.
  4. 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.
  5. Introduzca su dirección pública con /v1 al final, por ejemplo https://<your-tunnel-host>/v1.
  6. 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.

Importante: mientras está activo, el reemplazo es global. Desactívelo antes de volver a los proveedores integrados de Cursor.

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.

Modelos gratuitos para el chat de Cursor: llamadas a herramientas y contexto de 128K o más
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3UnoRouter1M1 solicitudes/min
1 req/min per model
SíNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSíSí
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 solicitudes/min
50 solicitudes/día
Shared rate limit
SíNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 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:fast para preguntas cortas y auto:smart para 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

ProblemaCausaSolución
Cursor no puede conectarse a http://localhost:3001/v1Cursor envía las solicitudes desde sus servidores, no desde su ordenadorUse una dirección HTTPS pública para el gateway
No aparece la opción de clave propiaSu plan de Cursor no incluye claves de API propiasConsulte 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 FreeLLMAPICopie de nuevo la clave unificada desde la página Keys
El autocompletado con Tab no usa el gatewayCursor siempre usa sus propios modelos para TabSin 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ímiteAñada claves de más proveedores o espere a que terminen los periodos de enfriamiento
Los modelos integrados dejan de funcionarEl reemplazo de la URL base sigue activoDesactive el reemplazo
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

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

Fuentes

Todas las guías · Ver todos los modelos gratuitos