Cursor con una sola API key para todos los modelos
Pega tu key de RelaySwitch en el campo OpenAI API Key de Cursor, sustituye la Base URL por https://api.relayswitch.io/v1 y añade los id de los modelos que quieras usar. Cada modelo de chat de esa key puede entrar en el selector de modelos, y funcionan tanto el modo Agent como el modo Ask.
01Cómo funciona y dónde está el ajuste
Cursor envía sus peticiones en formato OpenAI, y cada modelo de chat de la lista de modelos responde a ese formato. Así, una sola key cubre Claude, GPT, Gemini y DeepSeek en el mismo selector de modelos, cada uno a su precio por token actual y cobrado al saldo prepago.
El ajuste está en Cursor Settings (Cmd/Ctrl + ,), sección Models. Los campos de la key y de la Base URL están debajo de la lista de modelos.
02Los pasos en Cursor Settings
- Activa OpenAI API Key y pega la key completa de la consola.
- Activa Override OpenAI Base URL y escribe https://api.relayswitch.io/v1, con
/v1al final. - Haz clic en Save. Las versiones anteriores de Cursor llaman Verify a ese botón.
- En Models, añade uno a uno los id que quieras usar, tal como aparecen en la lista de modelos; los id de Claude también valen. Después elige uno en el panel de chat.
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03Qué hace cada campo
| OpenAI API Key | La credencial que Cursor envía en cada petición. Pega la key completa de la consola. |
| Override OpenAI Base URL | Envía esas peticiones a https://api.relayswitch.io/v1 en lugar de a OpenAI. |
| Models | La lista que ofrece el selector de modelos. Añade cada id que quieras usar tal como aparece en la lista de modelos, no su nombre visible. |
04Elegir modelo para Cursor
Una petición de Agent lleva la conversación, los archivos que Cursor ha leído y los resultados de las herramientas, así que los tokens de input son la mayor parte de la factura. Un modelo con un precio de input bajo da el menor costo por petición. La tabla siguiente recoge los modelos destacados en USD por millón de tokens; la página de cada modelo indica los precios de input, cached input y output.
| Modelo | Desarrollador | Input | Output | Contexto |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425 | $1.164 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873 | $0.1455 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625 | $0.20 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80 | $2.40 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105 | $0.42 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60 | $1.80 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90 | $4.50 | 1,048,576 |
USD por millón de tokens
05El modo Agent y los modelos GPT
Con el override de la Base URL activo, el modo Agent de Cursor envía a la ruta Chat Completions un cuerpo con formato de Responses API para los modelos GPT. Cursor lo tiene anotado como known issue en su foro.
El gateway lee ese cuerpo como la petición Chat Completions que pretendía ser y responde en formato Chat Completions, con o sin streaming. Los id de GPT funcionan en el modo Agent y en el modo Ask al mismo precio. Si prefieres un agente en la terminal, consulta la página de Codex y la página de Claude Code.
06Comprobar la conexión
Envía una petición como la que envía Cursor, desde la misma máquina. Después manda un mensaje en Cursor con uno de tus id seleccionado; la petición aparece en la página Usage de la consola con sus tokens y su costo.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'07Cobro, caché y errores frecuentes
Cómo crear una key y ponerle un presupuesto propio está en la página de Claude API key. Lo que conviene saber sobre el cobro, y después los cuatro errores más frecuentes:
- Las peticiones se cobran por token al precio del modelo, de tu saldo prepago.
- Cuando la respuesta informa de tokens de cached input, esos tokens se cobran al precio de cached input del modelo y no al de input. Una conversación larga que repite el mismo prefijo sale más barata por turno que una conversación nueva.
- En los planes Teams y Enterprise de Cursor, Cursor cuenta las peticiones con key propia dentro de su uso y les añade su propio costo por token. Ese costo lo cobra Cursor, no este sitio. Según la documentación de API keys de Cursor, en los planes individuales no se cuentan.
401 invalid_api_key | La key es incorrecta o fue revocada. Cópiala otra vez desde la consola. |
404 model_not_found | El id del selector de modelos no está en la lista de modelos. Revisa si hay un error al escribirlo o si pusiste el nombre visible en lugar del id. |
402 insufficient_balance | Recarga en la consola; la key vuelve a funcionar al instante. |
| Verify falla | La causa más habitual es una Base URL sin /v1. Ejecuta el curl de la sección anterior desde la misma máquina. |
Preguntas frecuentes
- ¿La Base URL de Cursor necesita /v1?
- Sí. Escribe https://api.relayswitch.io/v1 en Override OpenAI Base URL y Cursor añade /chat/completions detrás. La causa más habitual de que Verify falle es que falta el /v1.
- ¿Se pueden usar los modelos Claude en Cursor con esta key?
- Sí. Cada modelo de chat de la lista de modelos responde al formato OpenAI que envía Cursor, así que los id de Claude, GPT, Gemini y DeepSeek se pueden añadir al mismo selector de modelos con una sola key.
- ¿El modo Agent funciona con una API key propia?
- Sí, funcionan tanto el modo Agent como el modo Ask. Con los modelos GPT, el modo Agent envía a la ruta Chat Completions un cuerpo con formato Responses; el gateway lo lee como una petición Chat Completions y responde en ese formato al mismo precio.
- ¿Hay que activar el streaming?
- No. Cursor usa streaming por defecto y no tiene un interruptor para ello. Todos los modelos admiten streaming.
- ¿Cursor cobra algo adicional por usar una key propia?
- Según la documentación de API keys de Cursor, en los planes Teams y Enterprise las peticiones con key propia cuentan dentro del uso de Cursor y llevan un costo por token de Cursor, que cobra Cursor. En los planes individuales no se cuentan. Aquí las peticiones se cobran por token al precio del modelo, del saldo prepago.
- ¿Cómo recargo saldo para usarlo en Cursor?
- Recarga en la consola con tarjeta, incluidas Apple Pay y Google Pay, o con USDT, USDC, BTC, ETH, SOL, desde $10. El saldo se lleva en dólares estadounidenses, no caduca y no hay suscripción.
Todos los modelos en el selector de Cursor
Una key, saldo prepago, pago con tarjeta o cripto.