cursorapikey.com/Guía
Suscripción a Cursor frente a clave de API: ¿cuál cuesta menos?
La suscripción a Cursor frente a la clave de API se reduce a un número: cuántos tokens usas en un mes. Un plan fijo cuesta lo mismo si programas una hora o cien, mientras que una clave solo cobra por lo que envías.
Actualizado


Puntos clave
- Una sesión de codificación típica con 40 peticiones cuesta unos $0,166 a $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida.
- El uso ligero y medio cuesta unos pocos dólares hasta $11 al mes en la API; el uso diario intenso alcanza aproximadamente $37.
- Una suscripción puede incluir funciones que una clave personalizada no reemplaza, como el autocompletado integrado.
- Consulta el precio actual del plan tú mismo, luego divídelo por el costo por sesión para encontrar tu punto de equilibrio.
La decisión en una fórmula
Toma el precio mensual del plan que estás considerando, compruébalo en la página de precios de Cursor ya que cambia, y divídelo por lo que cuesta una sesión típica en la API. El resultado es el número de sesiones al mes en el que ambas opciones cuestan lo mismo. Por debajo de ese número, la clave es más barata. Por encima, el plan fijo gana solo por precio.
El resto de este artículo te da un costo realista por sesión, tres perfiles de uso y las diferencias no relacionadas con el precio que pueden superar unos pocos dólares.
Una nota de honestidad: los números de abajo usan solo nuestras propias tarifas. No citamos los precios de Cursor ni los de otros proveedores, porque cambian y debes leerlos en la fuente. Todo esto es aritmética que puedes rehacer con el tamaño de tu propia sesión.
Lo que cuesta una sesión de codificación en la API
Las tarifas son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Los chats de codificación son intensivos en entrada, porque cada petición lleva contexto de código, y la salida es corta en comparación.
Toma una sesión de 40 peticiones. Cada una envía unos 25.000 tokens (archivos abiertos, historial, instrucciones) y recibe unos 800 tokens.
- Entrada: 40 x 25.000 = 1.000.000 tokens, así que 1 x $0,15 = $0,15.
- Salida: 40 x 800 = 32.000 tokens, así que 0.032 x $0,50 = $0,016.
- Total: $0,166 por sesión.
Tus sesiones serán diferentes. Una ejecución larga de agente con contexto grande cuesta más; una pregunta rápida sobre una función cuesta una fracción de esto. Trata la cifra como un punto de partida, no como una promesa. Mide la tuya leyendo el campo usage en las respuestas, o observa el encabezado X-Balance-USD caer entre peticiones.
Tres perfiles de uso, 22 días laborables
| Perfil | Sesiones por día | Sesiones por mes | Costo mensual de la API |
|---|---|---|---|
| Luz | 1 | 22 | $3,65 |
| Media | 3 | 66 | $10,96 |
| Intenso | 10 | 220 | $36,52 |
Cada cifra es sesiones x $0.166, redondeado al centavo. Supongamos que un plan cuesta $20 al mes (una cifra inventada para los cálculos, así que usa la real). Entonces el punto de equilibrio es 20 / 0.166, unas 120 sesiones al mes, o aproximadamente cinco sesiones y media por día laborable. Por debajo, la API es más barata. Por encima, el precio fijo es.
La recarga mínima es de $20, y el crédito nunca caduca, así que un usuario ligero puede añadir $20 una vez y gastarlo a lo largo de muchos meses. No hay cuota mensual, lo que significa que un mes de inactividad no cuesta nada.
Lo que te da una suscripción que una clave no
El precio es solo parte. Una suscripción suele agrupar cosas que una clave personalizada no reemplaza. Las funciones que dependen de los propios modelos de Cursor, como el autocompletado en línea, suelen estar vinculadas al plan, y algunas funciones de agente dependen de modelos que no puedes cambiar. Consulta la documentación actual de Cursor para la división exacta, porque cambia entre versiones.
Una suscripción también te da la elección de varios modelos líderes detrás de un solo precio. Una clave te da un modelo, uncensored, que es un modelo de pesos abiertos ejecutado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito. No es una API oficial de ningún proveedor de modelos. Si necesitas el mejor modelo de código disponible para un problema difícil, el plan puede servirte mejor. Si necesitas un modelo que no rechace peticiones legítimas, o quieres un gasto predecible por token, la clave se ajusta.
Muchas personas usan ambos: el plan para el autocompletado y tareas pesadas, y la clave para el chat con un modelo que se comporta de manera diferente. Consulta alternativas a Cursor si también estás sopesando otros editores.
Otras cosas que cambian los cálculos
- Límites de peticiones. Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Una clave de prueba permite 2 y 60. Los planes fijos tienen sus propios límites, así que compáralos con tus hábitos.
- Tamaño del contexto. La ventana aquí es de 100.000 tokens, prompt más completion. Una petición que llena toda la ventana cuesta unos 100.000 / 1.000.000 x $0,15 = $0,015 en input. Varios de esos se suman rápido, así que recorta el contexto.
- Desperdicio. Las peticiones fallidas o rechazadas no se cobran. Los reintentos después de errores no cuestan nada extra, mientras que un plan fijo no tiene costo por petición.
- Bonificaciones. Las recargas desde $50 añaden 5%, desde $100 añaden 10%, desde $200 añaden 15%. Una recarga de $200 vale $230 de crédito.
Sea cual sea tu inclinación, vigila el mayor impulsor: tokens de entrada por petición. Cerrar pestañas no usadas y excluir carpetas de compilación del contexto los reduce en ambas opciones.
Un mes resuelto para una carga de trabajo mixta
Los meses reales son irregulares. Digamos que trabajas 22 días. En 12 de ellos haces una sesión ligera ($0,166 cada una), en 8 haces tres sesiones, y en 2 días de apuro haces ocho. Eso es 12 + 24 + 16 = 52 sesiones, que son 52 x $0,166 = $8,63. Una recarga de $20 duraría un poco más de dos meses a ese ritmo, y el saldo restante se queda en la cuenta.
Ahora añade un hábito de agente. Si dejas que un agente itere sobre un repositorio grande, una sola ejecución puede enviar 30 peticiones con 60.000 tokens de contexto cada una. Eso es 1,8M de tokens de entrada, o $0,27, más digamos 30.000 tokens de salida, $0,015. Una ejecución cuesta unos $0,285. Diez de esas ejecuciones en un mes añaden $2,85. Incluso con ese hábito, el total mensual aquí es $11,48, así que el trabajo de agente no es automáticamente caro, pero los contextos largos se multiplican rápido.
La lección es medir, no adivinar. Registra el campo de uso de algunas sesiones reales antes de decidir.
Cómo mantener bajos los gastos de la API
- Envía menos contexto. Incluye el archivo que estás editando y los archivos que importa, no todo el repositorio. Los tokens de entrada dominan la factura.
- Inicia chats nuevos. Una conversación larga reenvía todo su historial cada vez. Un chat nuevo para una nueva tarea reinicia el conteo.
- Limita la salida donde ayude.
max_tokenses opcional, pero un límite evita que una respuesta demasiado larga aumente el lado de salida a $0,50 por 1M. - Vigila el encabezado de saldo.
X-Balance-USDte dice lo que queda después de cada llamada. - Reintenta con cortesía. En un 429 con
Retry-After: 5, espera cinco segundos en lugar de hacer bucles.
Configuración de la clave para probarla
La forma más barita de decidir es probarla durante una semana. Reclama la prueba de $0,50 en la página de claves de API después de registrarte con Google o correo electrónico. Es válida por 7 días y no necesita tarjeta. En la configuración de modelos de Cursor, ingresa tu clave, activa la anulación de URL base con https://api.cursorapikey.com/v1, y añade un modelo personalizado llamado uncensored.
Para verificar la conexión fuera del editor:
from openai import OpenAI
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain what a mutex is in two sentences."}],
)
print(r.usage.prompt_tokens, r.usage.completion_tokens)
Si hay un error, la guía sobre el uso de la API de Cursor y la documentación enumeran las causas habituales. Rastrea tu uso de la API de Cursor durante una semana, multiplica por las tarifas y compáralo con el precio del plan. Los detalles sobre las tarifas están en la página de precios.
Más guías
Preguntas y respuestas
¿Es una clave de API más barata que la suscripción a Cursor?
Para uso ligero y medio, por lo general. Bajo el ejemplo anterior, unas 66 sesiones al mes cuestan alrededor de $11 en tokens. El uso diario intenso puede superar el precio de un plan fijo, así que revisa el precio actual del plan.
¿Puedo usar ambos a la vez?
Sí. Mantén el plan para las funciones vinculadas a él y añade tu propia clave para los modelos que elijas en el chat.
¿Cuánto cuesta una petición?
A $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, una petición con 25.000 tokens de entrada y 800 de salida cuesta $0,00375 más $0,0004, unos $0,0042.
¿Caduca el crédito?
No. El crédito no caduca y no hay cuota de suscripción en la API.
Tu clave está a un paso de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.