Cursor
En Cursor Models agrega un provider OpenAI-compatible personalizado, pega una Key dedicada, usa la URL base /v1 y agrega sólo IDs de modelo de la lista limitada por la Key. La interfaz cambia entre versiones, por lo que la comprobación final es una solicitud breve de Composer sin datos sensibles.
Antes de empezar
Instala la versión actual del cliente sólo desde su editor oficial. Antes de cambiar una configuración local, crea una API Key dedicada en la consola; no reutilices una Key personal, compartida o de despliegue de producción.
Windows, macOS y Linux
- Windows: usa el instalador actual de Windows o el flujo de PowerShell y cierra todos los procesos del cliente después de cambiar un archivo de configuración.
- macOS: usa la aplicación firmada o el instalador oficial de terminal para tu CPU; los ajustes del directorio personal pertenecen a ese usuario de macOS.
- Linux / WSL: sigue las instrucciones actuales de la distribución o del CLI oficial; WSL lee su directorio personal de Linux, no el perfil de Windows.
Elegir un modelo
Llama a GET /v1/models con la Key dedicada y selecciona un data[].id devuelto. La lista limitada por Key es la fuente de verdad; una configuración anterior, un artículo o un selector del cliente no garantiza acceso.
Configuración
API key: sk-your-own-key
Base URL: https://ai.tavonilo.com/v1
Model ID: copy one id from GET /v1/modelsVerificación
Comprueba la Key con /v1/models, realiza una solicitud pequeña sin datos sensibles y conserva sólo hora, ruta, modelo, estado HTTP e ID de solicitud para soporte. Un timeout no demuestra que una generación facturable no se procesó, por lo que no repitas ciegamente solicitudes largas o de imagen.
Recuperación segura
- 401: sustituye una Key incompleta, revocada o equivocada; no la pegues en una solicitud a soporte.
- 403: comprueba el grupo de la Key, visibilidad del modelo, saldo y permiso de ruta.
- 404: usa la Base URL mostrada aquí, no un endpoint completo, y no añadas /v1 dos veces.
- 429: encola el trabajo y respeta Retry-After si existe; no repitas un lote en paralelo.
- 5xx o timeout: reintenta de forma limitada sólo si la operación es segura. Conserva hora, ruta, modelo, estado HTTP e ID de solicitud en registros anonimizados.
Límite de credenciales
Usa una Key por dispositivo o carga de trabajo. Nunca envíes a soporte una API Key, auth.json, prompt privado completo, contraseña, código de verificación o datos de pago; revoca y reemplaza una Key de inmediato si sospechas exposición.