Vane

Ejecuta un motor de respuestas autohospedado con TokenMix como proveedor OpenAI.

Para Quién Es

Útil si quieres un motor de respuestas autohospedado tipo Perplexity. Combina resultados de búsqueda con respuestas del modelo para investigación, recopilación de información y preguntas web.

Preparar Datos De TokenMix

• Provider / type: OpenAI Compatible u OpenAI
• Base URL: https://api.tokenmix.ai/v1
• API Key: TokenMix API Key
• Model: TokenMix model ID, por ejemplo <your-model-short-id>

Qué Significa Cada Campo

• Provider / type decide qué protocolo API usará la app. Elige OpenAI Compatible, OpenAI o Custom OpenAI solo si permite configurar Base URL.
• Base URL es el endpoint real. Usa https://api.tokenmix.ai/v1, no el endpoint predeterminado de OpenAI, y no omitas /v1.
• API Key es la clave creada en TokenMix. Trátala como secreto: no la pongas en repos públicos, capturas, ejemplos ni logs de chat.
• Model es un TokenMix model ID, no el nombre de la app. Evita espacios extra y no mezcles nombres upstream con IDs de TokenMix.
• Embedding solo hace falta para búsqueda documental, indexación de knowledge base y similitud. Para la primera prueba de chat puedes dejarlo vacío.

Instalar O Abrir La App

1. Inícialo con Docker o Node siguiendo el README.
2. Prepara un servicio de búsqueda como SearXNG.
3. Abre Vane en el navegador y entra en settings.
4. Configura primero el model provider y después la fuente de búsqueda.

Elegir Una Opción De Despliegue

• Opción local más simple: Docker Bundle con Vane y SearXNG.
• Si ya tienes SearXNG: usa Docker Slim y configura SEARXNG_API_URL.
• Hosting one-click: Sealos, RepoCloud, ClawCloud y Hostinger.
• Desarrolladores: Node Local. Tras desplegar, cambia la Base URL del proveedor OpenAI a TokenMix en setup screen.

Configurar TokenMix

1. Añade un provider OpenAI.
2. API Key: TokenMix API Key.
3. Base URL: https://api.tokenmix.ai/v1.
4. Chat Model: TokenMix chat model ID.
5. Embedding Model: TokenMix embedding model ID.
6. Si la lista de modelos no carga, escribe el ID manualmente.

Primera Prueba

Busca “what is an OpenAI compatible API base URL” y responde brevemente con fuentes.

Ejecuta primero esta prueba una vez. Si funciona, haz después una prueba real pequeña de workflow o documento. No conectes datos de producción antes de que esta llamada básica funcione.

Después De La Primera Prueba

• Confirma primero que el servicio de búsqueda devuelve resultados antes de juzgar la calidad.
• Configura chat model y embedding model; si falta uno, resúmenes o relevancia pueden ser inestables.
• Si faltan citas, revisa el backend de búsqueda antes de cambiar modelos.
• Úsalo primero para investigación web pública; no conectes de inmediato datos internos sensibles.

Solución De Problemas

• 401 / unauthorized: clave incorrecta, espacios extra o clave caducada.
• model not found: model ID incorrecto, o tu cuenta no tiene acceso al modelo.
• Las solicitudes siguen yendo a OpenAI: Base URL no cambió a TokenMix, o elegiste otro provider.
• Salida corta o interrumpida: envía menos contexto o usa un modelo con más contexto.

Checklist Antes De Usar Datos Reales

• Prueba con una clave de test, proyecto temporal, documento de ejemplo o disparador manual antes de usar datos de producción.
• Revisa logs de la app, browser Network, terminal output o TokenMix request logs para confirmar llamadas a https://api.tokenmix.ai/v1.
• Asegúrate de que los errores sean comprensibles y no expongan API Key, detalles upstream ni rutas locales.
• Si la app puede enviar emails, actualizar CRM, escribir bases de datos o ejecutar comandos, empieza en draft-only o read-only.
• Después de validar, configura permisos de equipo, límites de presupuesto y reglas de uso en vez de compartir una clave con muchos privilegios.

Seguridad Para Principiantes

Prueba primero con un proyecto temporal, documento de prueba o disparador manual. Cuando las respuestas funcionen, conecta repositorios reales, bases de conocimiento o automatizaciones de producción. Para borrar archivos, ejecutar comandos, enviar emails, cambiar bases de datos o usar CRM, pide primero un plan en vez de ejecución directa.