# Cómo usar su propia clave API en Cursor IDE

Cursor Pro cuesta 20 $/mes con un límite de uso. Con una clave RunAPI paga por token — los mismos modelos Claude y GPT-4o al 50 % de las tarifas oficiales, sin tarifa mensual. Esta guía cubre la configuración de Settings &gt; Models, la anulación de la URL base y cómo corregir el error común &#39;unauthorized user api key&#39;.

*Updated June 23, 2026 · RunAPI Editorial*

## ¿Puedo usar Cursor con mi propia clave API?

Sí. Cursor admite bring-your-own-key (BYOK) en todos los planes, incluido el nivel gratuito. Ingresa una URL base y una clave API en Settings &gt; Models &gt; OpenAI API Key. RunAPI proporciona un endpoint compatible con OpenAI que funciona exactamente en ese campo, dándole acceso a Claude 3.5 Sonnet, GPT-4o y otros modelos al 50 % de lo que Anthropic y OpenAI cobran directamente. El error de configuración más común — el mensaje &#39;unauthorized user api key&#39; — significa que el formato de la clave es incorrecto o falta la URL base.

- **Funciona en todos los planes de Cursor**: BYOK está disponible en el nivel gratuito de Cursor y en Pro. No necesita una suscripción activa a Cursor Pro para usar su propia clave.
- **Endpoint compatible con OpenAI**: RunAPI usa el mismo formato de solicitud/respuesta que la API de OpenAI. El campo OpenAI API Key de Cursor lo acepta sin cambios de código.
- **50 % de descuento en precios oficiales de modelos**: RunAPI factura a la mitad del precio de lista del proveedor. La entrada Claude 3.5 Sonnet cuesta 1,50 $/M tokens a través de RunAPI frente a 3,00 $/M directamente a través de Anthropic.
- **Corregir &#39;unauthorized user api key&#39;**: Este error significa que Cursor rechazó el formato de la clave o no puede alcanzar el endpoint. La solución es verificar que tanto la URL base como la clave estén ingresadas correctamente en Settings &gt; Models.

## Dónde ingresar su clave API en Cursor

Cursor mantiene toda la configuración del modelo en un solo lugar. Abra Cursor, presione Cmd+Shift+J (Mac) o Ctrl+Shift+J (Windows/Linux) para abrir Configuración, luego navegue a la pestaña Models. Los campos relevantes son OpenAI API Key y OpenAI Base URL. Debe establecer ambos campos al usar RunAPI — la URL base le indica a Cursor que envíe solicitudes a RunAPI en lugar de directamente a OpenAI, y la clave autentica esas solicitudes.

## Corregir el error &#39;unauthorized user api key&#39; en Cursor

El mensaje &#39;unauthorized user api key&#39; de Cursor significa una de tres cosas: la clave API es incorrecta o ha expirado, la URL base no está configurada por lo que Cursor intenta validar la clave directamente contra los servidores de OpenAI, o el formato de la clave es incompatible. Las claves RunAPI comienzan con &#39;rp-&#39; — no son claves OpenAI estándar y siempre fallarán si Cursor intenta autenticarlas contra openai.com. La solución es siempre establecer la URL base junto con la clave.

### URL base faltante

La causa más común. Si OpenAI Base URL está en blanco, Cursor envía su clave RunAPI a api.openai.com, que la rechaza. Establezca la URL base en https://runapi.ai/v1 y el error desaparece.

### Clave copiada con espacios adicionales

Pegue la clave y verifique si hay un espacio inicial o final. Algunos terminales y navegadores agregan espacios en blanco invisibles al copiar. Borre el contenido del campo y pegue de nuevo si tiene dudas.

### Clave expirada o revocada

Las claves RunAPI pueden ser revocadas desde el panel de control. Si regeneró recientemente su clave, el valor anterior devolverá un 401. Copie la nueva clave desde Dashboard &gt; API Keys.

### Slug de modelo incorrecto

Si la clave y la URL son correctas pero un modelo específico devuelve un error, el nombre del modelo puede no coincidir con el catálogo de RunAPI. Verifique el slug exacto en runapi.ai/pricing y péguelo en el campo de modelo de Cursor.


## ¿Vale la pena Cursor Pro a 20 $/mes, o debería usar su propia clave?

Cursor Pro le ofrece una asignación mensual fija de solicitudes de modelo rápido. Una vez que supera el límite, Cursor lo ralentiza o detiene hasta el reinicio mensual. BYOK con RunAPI no tiene límite — paga por token al 50 % de las tarifas oficiales. Para la mayoría de los desarrolladores, el punto de equilibrio está alrededor de 8 a 12 horas de codificación intensiva con IA por mes. Por debajo de eso, RunAPI cuesta menos. Por encima, una suscripción se vuelve más predecible pero no necesariamente más barata.

## Cómo usar su propia clave API en Cursor con RunAPI

1. **Crear una cuenta RunAPI gratuita** — Vaya a runapi.ai y regístrese. No se requiere tarjeta de crédito. Obtiene un pequeño crédito gratuito para probar la conexión.
2. **Copiar su clave API y URL base** — En el panel de RunAPI, vaya a API Keys y genere una clave. Anote la URL base que se muestra en la página — es https://runapi.ai/v1.
3. **Abrir Configuración de Cursor** — En Cursor, presione Cmd+Shift+J (Mac) o Ctrl+Shift+J (Windows/Linux) para abrir Configuración. Haga clic en la pestaña Models.
4. **Ingresar la URL base** — Desplácese a la sección OpenAI. Pegue https://runapi.ai/v1 en el campo OpenAI Base URL. Este es el paso que la mayoría de las guías omiten — sin él, Cursor ignora su clave.
5. **Ingresar su clave RunAPI** — Pegue su clave RunAPI en el campo OpenAI API Key. Asegúrese de que no haya espacios iniciales o finales. Active la sección OpenAI si está desactivada.
6. **Seleccionar un modelo y probar** — En la barra de chat de Cursor, elija un modelo como gpt-5.4. Envíe un mensaje de prueba. Una respuesta confirma que la conexión funciona. Verifique su panel de RunAPI para ver el uso registrado.

## Preguntas frecuentes sobre la configuración de clave API en Cursor

### ¿Por qué Cursor muestra &#39;unauthorized user api key&#39;?

Este error aparece cuando Cursor no puede autenticar su clave contra el endpoint objetivo. La razón más común es que el campo OpenAI Base URL está vacío, por lo que Cursor envía su clave RunAPI a api.openai.com, que la rechaza. Establezca la URL base en https://runapi.ai/v1 junto con su clave para solucionarlo.

### ¿Necesito una suscripción a Cursor Pro para usar mi propia clave API?

No. Cursor BYOK funciona en el plan gratuito. Puede ingresar una clave API de terceros en Settings &gt; Models sin pagar por Cursor Pro. El nivel gratuito de Cursor aún impone algunos límites en sus propias solicitudes de modelo integradas, pero esos no aplican cuando proporciona su propia clave.

### ¿Qué modelos puedo usar en Cursor a través de RunAPI?

Cualquier modelo en el catálogo de RunAPI que exponga un endpoint de completions de chat — incluyendo Claude 3.5 Sonnet, Claude 3.7 Sonnet, GPT-4o, GPT-4.1, Gemini 1.5 Pro y Llama 3.1. Ingrese el slug de modelo exacto de runapi.ai/pricing en el campo de modelo de Cursor. Los modelos de imagen y audio no están disponibles en la interfaz de chat de Cursor.

### ¿Es RunAPI más barato que Cursor Pro?

Para uso ligero a moderado, sí. Cursor Pro a 20 $/mes es adecuado para desarrolladores que desean una tarifa fija. RunAPI factura por token al 50 % de los precios de lista del proveedor — Claude 3.5 Sonnet cuesta 1,50 $/M tokens de entrada. Los usuarios intensivos que permanecen dentro del límite Pro pueden encontrar la suscripción más predecible, pero no hay limitación con RunAPI.

### ¿Puedo usar la misma clave RunAPI en Windsurf y Claude Code también?

Sí. Una clave RunAPI funciona en Cursor, Windsurf, Claude Code, Codex y cualquier otra herramienta que acepte un endpoint personalizado compatible con OpenAI. El uso y el gasto se consolidan en un panel de RunAPI, por lo que no necesita administrar claves o saldos separados por herramienta.

### ¿Cuál es la OpenAI Base URL que necesito ingresar en Cursor?

Establézcala en https://runapi.ai/v1. Cursor usa esta URL para todas las solicitudes de modelo cuando la sección OpenAI está activa. Sin este campo, Cursor envía sus solicitudes a api.openai.com, que rechazará una clave RunAPI y devolverá un error no autorizado cada vez.

### ¿El uso de BYOK en Cursor deshabilita las funciones integradas de Cursor?

No. El autocompletado, la vista de diferencias y las funciones de agente de Cursor siguen funcionando. BYOK solo cambia qué modelo y endpoint usa Cursor para el chat y las completions en línea. Si establece un modelo que la interfaz de usuario de Cursor no lista por defecto, escriba el slug directamente en el selector de modelos.

### ¿Cómo sé si mi clave RunAPI está funcionando en Cursor?

Envíe un mensaje corto en el chat de Cursor y verifique el panel de RunAPI en Uso. Una nueva entrada de registro con el nombre del modelo, el recuento de tokens y el costo aparece a los pocos segundos de cada solicitud. Si no aparece ninguna entrada, la URL base o la clave no están llegando a RunAPI.