¿Cómo configurar el cursor de gate.ai en Cursor?

Gate.AI compatible con OpenAI permite a los desarrolladores conectar Cursor a Gate.AI mediante una clave API de Gate.AI, la URL base compatible con OpenAI y el ID de modelo soportado, hasta junio de 2026. Para quienes desean enviar solicitudes de modelos desde Cursor Chat, Composer, Agent u otras interfaces de código a través de Gate.AI en lugar del proveedor de modelos predeterminado, esta configuración es especialmente importante. Esta guía cubre únicamente el proceso de configuración en Cursor; para conocer modos más amplios de integración API, consulte la Guía de integración API de Gate.AI.

Requisitos previos

• Cursor instalado.
• Clave API de Gate.AI disponible.

Contenido basado en: Documentación oficial de Gate.AI y capturas de pantalla de configuración de Cursor, hasta junio de 2026.

¿Qué puedes hacer después de completar esta guía?

Tras configurar Gate.AI en Cursor, podrás agregar Gate.AI como ruta de modelos personalizada en Cursor, ingresando la clave API de Gate.AI y la URL base compatible con OpenAI, seleccionando modelos como deepseek/deepseek-v3.2, y usando ese modelo en la interfaz de chat o en el agente de Cursor.

Esta guía solo cubre la configuración en la interfaz de Cursor. No incluye integración SDK, configuración de Claude Code, Claude Desktop ni permisos empresariales.

Paso 1: Abrir configuración de Cursor

Este paso abrirá la sección de configuración de Cursor para gestionar modelos y ajustes de API.

Acción: En Cursor, ve a la esquina superior derecha y haz clic en el icono de configuración. La ruta en la documentación oficial de Gate.AI para acceder a Cursor es menú superior derecho → Configuración.

Antes de cambiar la configuración del modelo, ingresa a la configuración de Cursor desde el menú superior derecho.

Paso 2: Abrir configuración de modelos

Este paso accederá a la página de configuración de modelos en Cursor.

Acción: En la configuración de Cursor, en la barra lateral izquierda selecciona Modelos. Si no aparece toda la lista de modelos, selecciona Ver todos los modelos. La documentación oficial de Gate.AI indica que la ruta para agregar modelos personalizados en Cursor es Modelos → Ver todos los modelos.

Gestiona modelos integrados, modelos personalizados y configuraciones API desde la sección de modelos.

Paso 3: Hacer clic en agregar modelo personalizado

Este paso creará una nueva entrada de modelo personalizado para Gate.AI.

Acción: Desplázate hasta el final de la lista de modelos y haz clic en Agregar modelo personalizado. La documentación oficial indica que en la configuración de Cursor, debes desplazarte hasta el final y seleccionar Agregar modelo personalizado.

Tras agregar un modelo personalizado, se abrirá un campo para ingresar el ID del modelo de Gate.AI.

Paso 4: Agregar ID del modelo de Gate.AI

Este paso indica qué modelo soportado por Gate.AI procesará las solicitudes.

Acción: En Cursor, ingresa el ID del modelo de Gate.AI y haz clic en Agregar. Usa el formato provider/nombre-del-modelo, por ejemplo deepseek/deepseek-v3.2. La documentación oficial de Gate.AI señala que el ID del modelo debe obtenerse del mercado de modelos y no usar auto en la configuración.

Según la documentación oficial de Gate.AI (hasta junio de 2026), el ID del modelo debe tener el formato provider/nombre-del-modelo, siendo deepseek/deepseek-v3.2 un ejemplo de ID soportado.

Paso 5: Ingresar clave API y URL base de Gate.AI

Este paso conecta la sección de API compatible con OpenAI en Cursor con Gate.AI.

Acción: En la sección Clave API, habilita Clave API de OpenAI y pega tu clave API de Gate.AI. Luego, activa Sobrescribir URL base de OpenAI e ingresa la URL base, que será:

La documentación oficial de Gate.AI indica que la URL base compatible con OpenAI es /openai/v1, no solo /v1.

En Cursor, ingresa el ID del modelo de Gate.AI, la clave API y la URL base.

Paso 6: Seleccionar el modelo de Gate.AI en Cursor Chat

Este paso confirma que Cursor puede usar el modelo de Gate.AI en conversaciones de código.

Acción: Cierra la configuración de Cursor, abre Cursor Chat, Composer, Agent u otra interfaz de diálogo, y en el selector de modelos selecciona el modelo que agregaste. La documentación oficial de Gate.AI indica que los modelos agregados pueden seleccionarse en Chat, Composer, Agent y otras interfaces.

Deberías ver en el selector de modelos el nombre del modelo configurado, como deepseek/deepseek-v3.2.

Una vez configurado, selecciona el modelo de Gate.AI en el selector de modelos de Cursor y envía comandos.

¿Qué valores debe ingresar en la configuración de gate.ai en Cursor?

| Campo de Cursor | Valor de entrada | Reglas de configuración | | --------------------------- | -------------------------------------------------------------- | ------------------------------------------------ | | ID del modelo personalizado | Ejemplo: deepseek/deepseek-v3.2 | Usa formato provider/nombre-del-modelo, no auto. | | Clave API de OpenAI | Tu clave API de Gate.AI | Verifica que la clave sea válida y esté bien copiada. | | URL base de OpenAI | | Usa /openai/v1, no solo /v1. | | Selector de modelos | El modelo que agregaste | Selección previa antes de enviar comandos. |

El ID del modelo y la URL base son los campos más críticos en la configuración de gate.ai en Cursor. Si Cursor acepta la clave pero no puede enrutar solicitudes, revisa primero el formato del ID del modelo y la URL base, antes de modificar otras configuraciones.

Lista de verificación para solucionar problemas si Gate.AI no funciona en Cursor

• Problema: Cursor muestra error 401 o falla en la conexión.

  • Causa: La clave API de Gate.AI es inválida, expiró, fue revocada, está deshabilitada, copiada incorrectamente o la cuenta no tiene saldo suficiente.
  • Solución: Verifica el estado de la clave API en Gate.AI, vuelve a copiarla, asegúrate de que la cuenta tenga saldo suficiente. La documentación oficial indica que claves inválidas o saldo insuficiente son causas comunes de fallos en autenticación o solicitudes.

• Problema: Cursor indica que el modelo no está disponible o no se encuentra.

  • Causa: Error en la escritura del ID del modelo, no usar formato provider/nombre-del-modelo, o poner auto.
  • Solución: Copia el ID correcto desde la lista de modelos de Gate.AI y usa un ID específico como deepseek/deepseek-v3.2.

• Problema: Cursor devuelve errores desconocidos de API o 404.

  • Causa: La URL base está mal ingresada.
  • Solución: Corrige la URL base a /openai/v1.

• Problema: El modelo personalizado no aparece en Cursor Chat.

  • Causa: No guardaste la configuración en Cursor o no actualizaste la lista de modelos.
  • Solución: Guarda la configuración, cierra y reinicia Cursor, y revisa la lista de modelos.

• Problema: Un modelo funciona y otro no.

  • Causa: El ID del modelo no coincide exactamente con el de Gate.AI, o hay restricciones en la cuenta o en las políticas de seguridad.
  • Solución: Verifica en la documentación de Gate.AI el formato correcto del ID y revisa si hay restricciones en la cuenta o en las políticas de seguridad.

¿Qué más puedes configurar o desarrollar después?

Para integraciones más amplias, consulta la Guía de integración API de Gate.AI. Esa guía explica en detalle cómo conectar Gate.AI en el proceso de desarrollo compatible con OpenAI.

Para referencias oficiales, usa la documentación de Gate.AI. Para selección de modelos, revisa la lista de modelos de Gate.AI. Si hay presupuestos o límites de uso, revisa los precios de Gate.AI antes de producción.

Preguntas frecuentes

¿Puedo usar auto como ID de modelo en Cursor?

No. La documentación oficial de Gate.AI indica que en Cursor se debe usar un ID de modelo específico del mercado, no auto.

¿Qué URL base de Gate.AI debo ingresar en Cursor?

Usa /openai/v1. La documentación oficial enfatiza que la ruta compatible con OpenAI es /openai/v1, no solo /v1.

¿Dónde selecciono el modelo de Gate.AI después de configurar?

Abre Cursor Chat, Composer, Agent u otra interfaz, y en el selector de modelos selecciona el modelo que agregaste.

¿Por qué la clave API funciona en otros lugares pero no en Cursor?

Podría ser que Cursor esté usando un modelo no guardado, una URL base incorrecta o un ID de modelo equivocado. Revisa los valores del ID, la clave API, la URL base y el selector de modelos.