Cherry Studio
Usa exactamente los valores de protocolo siguientes, reinicia el cliente después de guardar y realiza una solicitud privada corta antes de activar trabajo prolongado, tools o media.
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
Provider protocol: OpenAI-compatible
Base URL: https://ai.tavonilo.com/v1
API key: sk-your-own-key
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.