Skip to main content

Configuración de API personalizada

Configuración de API de FiloMail con un proveedor de IA personalizado

Filo Plus incluye IA administrada por Filo. Si prefieres el plan Gratis, puedes conectar tu propio proveedor de IA o un modelo local en Filo Desktop y seguir usando las funciones de Filo AI con tu propia cuota de API.

La API personalizada se configura por dispositivo en Filo Desktop. No necesitas Filo Plus para usar el proveedor configurado, pero sí un modelo compatible y el saldo o la facturación que exija el proveedor. Los cargos del proveedor son independientes de Filo.

Elige cómo usar Filo AI

Filo Plus

La opción más sencilla. Filo gestiona los modelos, el servicio y la cuota, sin que tengas que mantener una cuenta de API, una clave o una factura externa.

Plan Gratis + API personalizada

Conecta un proveedor compatible, un endpoint OpenAI-Compatible o un modelo local. Filo ofrece la experiencia de IA; tu proveedor ofrece el modelo y factura el uso.

Funciones disponibles con una API personalizada

Resúmenes y tareas automáticas

Resume correos e hilos, identifica acciones y convierte automáticamente los mensajes relevantes en tareas.

Conversación con IA

Haz preguntas, explora el contexto del correo y utiliza la experiencia de conversación de Filo AI con el modelo elegido.

Compose y respuesta rápida

Redacta mensajes y respuestas, reescribe texto y adapta el tono o las palabras antes de enviar.

Traducción y otras acciones de IA

Usa la traducción con IA y las demás herramientas respaldadas por el proveedor que incluya tu versión de Filo Desktop.

Antes de empezar

  • •Actualiza Filo Desktop a la última versión. Si Configuración no muestra API Configuration o Custom AI (BYOK), tu versión instalada todavía no incluye la función.
  • •Para un proveedor en la nube, crea una cuenta, activa la facturación o añade saldo cuando sea necesario y genera una API Key. Una suscripción de consumo a ChatGPT, Claude o Gemini normalmente no incluye uso de API.
  • •Elige un modelo adecuado. La conversación con IA y las acciones de Agent funcionan mejor con modelos que admiten llamadas a herramientas y una ventana de contexto suficiente.
  • •Para un proveedor local, instálalo, descarga un modelo e inicia el servidor antes de probar la conexión en Filo.

Tipos de proveedores compatibles

Proveedores de modelos en la nube

OpenAI, Anthropic, Google Gemini, DeepSeek, xAI, Qwen, Mistral, Z.AI, Doubao, Moonshot, MiniMax, Together, Fireworks, Groq, Cerebras, SambaNova, Nebius y Hugging Face.

Routers y gateways

OpenRouter, Requesty, Vercel AI Gateway, AIHubMix y otros servicios de enrutamiento compatibles permiten acceder a varias familias de modelos desde una sola cuenta.

OpenAI-Compatible

Conecta un servicio personalizado compatible con OpenAI mediante su API Base URL, API Key e ID exacto del modelo. Se admite una URL base como https://api.example.com/v1 o una URL completa /chat/completions.

Local y autohospedado

Ollama y LM Studio se ejecutan en este ordenador sin API Key. LiteLLM puede ejecutarse local o remotamente y su clave es opcional; los despliegues remotos deben usar HTTPS.

Qué significa cada campo

Provider

Elige la empresa o endpoint que recibirá las solicitudes de Filo AI. Usa OpenAI-Compatible para un endpoint personalizado compatible.

API Base URL

La dirección raíz de la API. Mantén el valor oficial salvo que el proveedor documente otra URL. Los servicios personalizados o autohospedados requieren la dirección exacta.

API Key

La credencial secreta del proveedor, no la contraseña normal de tu cuenta. Ollama y LM Studio no la necesitan; en LiteLLM puede ser opcional.

Model

El modelo que usará Filo. En los proveedores que ofrecen una lista de modelos, Filo solo muestra los que admiten tanto todas las llamadas a herramientas del Agent como la comprensión multimodal de imágenes. Filo necesita ambas capacidades para participar en tareas de procesamiento de correo, por lo que los modelos que no cumplen estos requisitos no están disponibles para su selección. Para un endpoint personalizado, elige un modelo con ambas capacidades e introduce su ID exacto, incluido un namespace como provider/model cuando sea necesario.

Reasoning effort

Cuando aparezca, Low es más rápido y normalmente más barato; High dedica más tiempo y tokens a tareas difíciles. Medium es una buena opción predeterminada.

Configura la API personalizada paso a paso

  1. Abre Filo Desktop y ve a Configuración → API Configuration.
  2. Busca y selecciona tu proveedor. Elige OpenAI-Compatible para un servicio compatible personalizado, u Ollama, LM Studio o LiteLLM para una configuración local o autohospedada.
  3. Comprueba la API Base URL. Los proveedores oficiales se rellenan automáticamente. En OpenAI-Compatible, introduce la URL base o la URL completa /chat/completions. Las URL remotas deben usar HTTPS; Ollama y LM Studio deben usar localhost u otra dirección loopback.
  4. Pega la API Key del proveedor. Omite este paso para Ollama o LM Studio; añádela en LiteLLM solo si tu despliegue la exige.
  5. Elige un modelo. Si no aparece un catálogo, introduce el ID exacto del proveedor o servidor local.
  6. Selecciona Reasoning effort si aparece. Déjalo en Medium si no estás seguro.
  7. Selecciona Test connection. Filo envía una pequeña solicitud de verificación y solo guarda la credencial después de que el proveedor acepte la configuración.
  8. Cuando el proveedor muestre Ready, activa Enable Custom AI.
  9. Abre un correo y prueba un resumen, extracción de tareas, conversación con IA o borrador. Si cambias la clave, URL o modelo, vuelve a probar la conexión.

Qué cambia al activarlo

  • •Las funciones compatibles de Filo Desktop usan el proveedor y modelo elegidos, incluidos resúmenes, tareas automáticas, conversación con IA, Compose, respuestas y traducción.
  • •La configuración y la credencial permanecen en este dispositivo y no se sincronizan automáticamente con otros ordenadores o dispositivos móviles.
  • •Al desactivar Enable Custom AI, Filo vuelve a la IA administrada por Filo. El acceso dependerá entonces de tus beneficios del plan Gratis o Filo Plus.
  • •Las solicitudes respaldadas por el proveedor no consumen cuota de Filo AI, pero no son ilimitadas: siguen sujetos el saldo, los límites, el modelo y la disponibilidad regional del proveedor.

Seguridad y facturación

  • •La credencial se guarda de forma segura en este dispositivo y solo se envía al endpoint del proveedor que elijas.
  • •Las solicitudes pueden incluir el texto del correo, el contexto del hilo, el borrador, el contenido de adjuntos o la información de tareas necesaria para completar la acción.
  • •No compartas capturas ni configuraciones exportadas que incluyan tu API Key o token de autorización.
  • •El proveedor controla precios, retención, entrenamiento, región de procesamiento, límites y disponibilidad. Revisa su política de datos antes de enviar correo sensible.
  • •Usa una clave dedicada cuando sea posible, establece un límite de gasto en el proveedor y rótala de inmediato si puede haberse expuesto.

Solución de problemas

  • •401 o 403 indica que la clave fue rechazada. Comprueba que esté activa, pertenezca al proveedor elegido y tenga permiso para usar el modelo.
  • •429 indica que alcanzaste el límite o saldo del proveedor. Espera, añade crédito, aumenta el límite o cambia de modelo.
  • •404 suele significar que la Base URL o el ID del modelo son incorrectos. Verifica ambos y evita añadir la misma ruta dos veces.
  • •Un error de dirección bloqueada o HTTPS significa que el endpoint no cumple las reglas de seguridad de red de Filo. Los servicios remotos requieren HTTPS; Ollama y LM Studio requieren una dirección loopback.
  • •Si falla una conexión local, inicia el servidor, confirma el puerto y comprueba que el modelo haya terminado de descargarse.
  • •Si los prompts sencillos funcionan pero falla una acción de Agent, usa un modelo con llamadas a herramientas y mayor contexto, y vuelve a probar.
  • •Si no aparece API Configuration, actualiza Filo Desktop y comprueba si tu versión incluye la función.