Perfiles y Proveedores de IA · Ayuda de ZeroChat

1. Gestión de Perfiles de Conexión

ZeroChat te permite definir múltiples perfiles de conexión. Un perfil encapsula la interfaz/protocolo de la API, la URL del servidor o endpoint, la clave de acceso (opcional en servidores locales) y el modelo seleccionado.

Para gestionar perfiles, haz clic en el nombre del perfil activo en la cabecera. El selector permite crear y exportar perfiles, cerrar el menú y editar o borrar cada perfil de la lista. Al elegir uno, pasa a ser el perfil activo.

Conmutación instantánea: Puedes cambiar de modelo o de proveedor entre mensajes sin perder el hilo de la conversación. Solo tienes que desplegar el menú de perfil y elegir otro.

El selector permite Exportar todas las definiciones editables. Se descarga un archivo HTML cifrado: ábrelo para iniciar la importación en ZeroChat. Tras confirmar, se añaden los perfiles nuevos y se actualizan los que comparten identificador, sin alterar el perfil Espejo.

Las claves de API se guardan cifradas en el almacenamiento local del navegador y permanecen cifradas dentro de la copia, que añade una segunda capa de cifrado. La casilla Bloquear cambios, ubicada en la cabecera del editor, marca el perfil como no editable al volver a cargarlo; el bloqueo protege todos los parámetros del perfil. Los ajustes se aplican mediante el botón Guardar de la cabecera.

Desde Configuración → Contraseña de cifrado puedes proteger las API keys con una contraseña propia. ZeroChat no guarda la contraseña: conserva temporalmente su hash en el almacenamiento del navegador durante 24 horas para compartir el desbloqueo entre pestañas. Después tendrás que escribirla de nuevo. La acción Usar clave predeterminada solicita la clave actual y vuelve a cifrar todas las API keys con la clave integrada de ZeroChat.

2. Proveedores y Protocolos Compatibles

Tipo de Interfaz	Servidores / Servicios Habituales	Endpoint Típico	Clave de API
OpenAI / Compatible	LM Studio, LocalAI, vLLM, OpenAI oficial	`http://localhost:1234/v1`	Opcional en local / Requerida en OpenAI
Ollama	Servidor local Ollama	`http://localhost:11434`	No requerida
OpenRouter	Plataforma multimodelo OpenRouter	`https://openrouter.ai/api/v1`	Requerida (`sk-or-...`)
Anthropic Claude	API oficial de Anthropic	`https://api.anthropic.com/v1`	Requerida (`sk-ant-...`)
Google Gemini	Google AI Studio	Endpoint OpenAI-compatible de Gemini	Requerida
WebLLM	Navegador web directo (WebGPU)	`webllm://local` (automático)	No aplicable (100% local)
Espejo (Mirror)	Pruebas internas sin conexión	Sin endpoint (modo simulado)	No aplicable

3. Consulta de Servidor (Botón Query) y Validación

Al crear o editar un perfil, ZeroChat incorpora el botón Query junto al campo de URL. Esta función realiza una inspección activa del servidor antes de guardar:

Detección de modelos: Descarga la lista oficial de modelos alojados o disponibles en el servidor y rellena el desplegable automáticamente.
Inspección de capacidades: Detecta si el modelo soporta visión multimodal, herramientas (function calling), razonamiento nativo y la capacidad de ventana de contexto anunciada por el servidor.
Protección de guardado: En proveedores que dependen de red externa o servidores locales, ZeroChat exige una consulta satisfactoria antes de guardar para garantizar que la conexión funciona y evitar errores durante el chat.

Excepción ágil en WebLLM: Si utilizas WebLLM y seleccionas un modelo que ya ha sido descargado previamente en la caché del navegador, el botón Query se vuelve opcional y puedes guardar el perfil de inmediato.

4. Configuración Especial para Ollama (CORS)

Si utilizas Ollama, el navegador puede bloquear las peticiones debido a la política de seguridad CORS (Cross-Origin Resource Sharing) si Ollama solo escucha en su origen por defecto.

Para solucionarlo, inicia el servicio de Ollama permitiendo el origen de tu navegador:

# En Linux / macOS (terminal)
OLLAMA_ORIGINS="*" ollama serve

# En Windows (PowerShell)
$env:OLLAMA_ORIGINS="*"
ollama serve

Si ejecutas Ollama como servicio de systemd en Linux, añade Environment="OLLAMA_ORIGINS=*" en la sección [Service] de su configuración.

5. El Perfil "Espejo" (Mirror) para Pruebas

ZeroChat incluye de serie el perfil de solo lectura Espejo. Este perfil es ideal para pruebas de interfaz y diagnóstico:

No realiza ninguna petición a la red ni requiere servidores locales encendidos.
Devuelve de inmediato un resumen formateado del mensaje enviado y de la estructura de la petición OpenAI normalizada.
Actúa como perfil de respaldo seguro si eliminas el perfil activo o si un perfil configurado no está accesible.