OpenCode
Usa la configuración de OpenCode generada en API Keys -> Use key, o configura un provider OpenAI con la URL base /v1. Inicia OpenCode en un proyecto y elige sólo un modelo expuesto por la Key activa; una lista fija del cliente no garantiza disponibilidad.
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
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openai": {
"options": {
"baseURL": "https://ai.tavonilo.com/v1",
"apiKey": "sk-your-own-key"
}
}
}
}Verificació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.