Cursor

Usa los modelos GPT de OneProvider en Cursor: define Override OpenAI Base URL, elige un modelo para Ask y Agent y confirma que las solicitudes se cuentan.

Usa el Override OpenAI Base URL de Cursor para ejecutar en Ask y Agent los modelos GPT del catálogo de OneProvider.

Todos los modelos, capacidades y precios Índice de la documentación para agentes de IA: https://oneprovider.dev/docs/llms.txt

Editor de código con IA Cursor

Documentación oficial

Qué funciona

Las solicitudes de Ask y Agent con los ID de modelo GPT que añadas pasan por OneProvider, incluidas las solicitudes ApplyPatch en streaming. Cursor envía estas solicitudes desde sus propios servidores, así que solo funciona el endpoint público; Cursor sigue controlando su entorno de ejecución del agente y sus funciones alojadas especializadas.

Limitación del cliente

Requiere un plan de pago de Cursor (Pro o superior): desde enero de 2026 Cursor ignora tus propias claves en el plan Free. El override es global: mientras está activado, todos los modelos excepto los de Anthropic y Google, incluidos los modelos GPT, Composer y Grok propios de Cursor, se envían a OneProvider, así que apágalo para volver a usar los modelos de Cursor. Los ID integrados de Anthropic/Claude y de Google nunca usan el override, y el autocompletado con Tab y las funciones alojadas por Cursor mantienen su enrutamiento normal.

Antes de empezar: una clave de tu panel Abre tu panel: el bot de Telegram @oneprovider_robot (Panel) o app.oneprovider.dev . Pulsa “Emitir una clave”, ponle un nombre (por ejemplo, este cliente) y un límite de gasto, y copia la clave. El saldo se recarga en el mismo lugar. Más sobre el panel y las claves .

Configuración

Actualiza Cursor y prepara una clave dedicada
Usa la última versión estable de Cursor con un plan Pro o superior. Crea una clave de OneProvider dedicada, limita sus modelos y su gasto, y recarga el saldo antes de verificar.
Activa la OpenAI API Key
Abre Cursor Settings → Models → API Keys (Ajustes de Cursor → Modelos → Claves de API), pega la clave dedicada de OneProvider en OpenAI API Key y enciende su interruptor: pegar la clave por sí solo no la activa.
```
OpenAI API Key: sk-your-key-here
```
Sobrescribe la base URL de OpenAI
Enciende Override OpenAI Base URL (Sobrescribir la base URL de OpenAI) e introduce exactamente https://api.oneprovider.dev/v1: con /v1 y sin /chat/completions; Cursor añade la ruta por sí mismo. Cursor exige un ID de modelo OpenAI compatible; elige el ID de un modelo de texto GPT del catálogo de modelos (un modelo de imágenes no funciona en el chat).
```
Override OpenAI Base URL: https://api.oneprovider.dev/v1
```
Guarda y selecciona un modelo compatible
Guarda la clave de OpenAI y la base URL. Añade como modelo personalizado el ID compatible que elegiste, si no aparece en la lista, y luego haz una solicitud nueva en Ask o Agent. Los ID de modelo de Claude y de Google no pasan por este override. Desactiva el override cuando quieras recuperar el enrutamiento normal de OpenAI de Cursor.

Verifica la conexión

Confirma la solicitud en tu Dashboard

La solicitud debe mostrar gpt-6.1-terra, el endpoint compatible con OpenAI, el consumo de tokens y el importe cobrado. Si Cursor muestra un error en su lugar:

"does not work with your current plan or api key" → plan Free, o el interruptor de OpenAI API Key está apagado
"Model name is not valid" → enciende el interruptor de OpenAI API Key y empieza un chat nuevo
404 / "Invalid URL" → la base URL debe ser exactamente https://api.oneprovider.dev/v1
401 → clave de OneProvider incorrecta, revocada o sin saldo
"model … is not available" → el ID del modelo no está en el catálogo de OneProvider
Los modelos propios de Cursor fallan → apaga Override OpenAI Base URL mientras los uses

Datos de conexión

Protocolo: openai-chat
Endpoint: https://api.oneprovider.dev/v1

Seguridad de la clave

Cursor compone las solicitudes a través de su propio servicio, así que no restrinjas la clave a la IP de tu equipo. Es mejor una clave dedicada con controles de modelo, frecuencia, gasto, caducidad y alcance.

Qué modelo elegir

El override solo admite ID de modelo de estilo OpenAI, así que elige un modelo de texto GPT. gpt-6.1-terra es la opción equilibrada por defecto para Ask y Agent. gpt-6.1-sol es el nivel de gama alta para tareas difíciles de varios archivos, y gpt-5.6-luna es el nivel económico para preguntas rápidas. Añade el ID que elegiste como modelo personalizado, exactamente como está escrito en el catálogo . Los ID de Claude nunca pasan por este override: para usar Claude, ejecuta Claude Code junto a Cursor.

Errores frecuentes y soluciones

“Model name is not valid”

El interruptor de OpenAI API Key está apagado o el modelo se añadió antes de encenderlo. Enciende el interruptor, guarda y empieza un chat nuevo.

“Does not work with your current plan or api key”

Estás en el plan Free o el interruptor está apagado. En Free, Cursor ignora tus propias claves; hace falta Pro o superior.

404 o “Invalid URL”

Introduce exactamente https://api.oneprovider.dev/v1: con /v1 y sin /chat/completions. Cursor añade la ruta.

401

La clave es incorrecta, está revocada o el saldo está vacío. Pega la clave completa sin espacios y recarga el saldo del panel.

Los modelos propios de Cursor fallan con el override activado

El override es global: todo modelo que no sea de Anthropic ni de Google va a OneProvider. Apaga Override OpenAI Base URL para volver a usar los modelos de Cursor.

Las solicitudes no aparecen en mi Dashboard

El modelo que usaste es de Claude o de Google, o el override está apagado. Elige el ID de GPT que añadiste y haz una solicitud nueva en Ask o Agent.

Preguntas frecuentes

¿Afecta al autocompletado con Tab?

No. Tab y las funciones alojadas por Cursor mantienen su enrutamiento normal.

¿Puedo restringir la clave a mi IP?

No. Cursor envía las solicitudes desde sus propios servidores, así que una lista de IP permitidas las bloquearía. Usa en su lugar límites de modelo, de frecuencia y de gasto.

¿Puedo usar modelos Claude en Cursor a través de OneProvider?

No con este override. Para Claude usa Claude Code o Cline .

¿Cómo vuelvo atrás?

Apaga Override OpenAI Base URL. El resto de tus ajustes se conserva.

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .

Última actualización: 2026-11-08 ¿Encontraste un error? @Oneproviderhelpbot