Guía completa para conectar Open WebUI con APIs compatibles con OpenAI

¿Cómo conectar Open WebUI con una API compatible con OpenAI? Si te has bajado Open WebUI y quieres llevar la experiencia al siguiente nivel, habrás notado que no hace falta quedarse solo con lo básico. La verdadera chicha está en conectar el software con APIs externas que sigan el estándar de OpenAI, lo que te permite saltar de un modelo a otro sin complicaciones y aprovechar la potencia de los mejores servidores del momento.

Lo mejor de todo es que Open WebUI no se limita a un solo proveedor, sino que actúa como un centro de mando basado en protocolos. Esto significa que, mientras el servicio externo hable el lenguaje de Chat Completions de OpenAI, podrás integrarlo en unos pocos clics, ya sea para usar modelos ultrarrápidos, agentes de razonamiento complejo o soluciones integradas en la nube de Amazon.

Configuración básica de conexiones OpenAI

Para empezar a meterle mano a la configuración, debes dirigirte al Panel de Administración, entrar en Ajustes y buscar la sección de Conexiones. Allí verás que puedes añadir nuevas conexiones OpenAI pulsando el icono del signo más. En este punto, lo primordial es introducir la URL base del servicio y tu clave API personal.

Si estás utilizando Azure OpenAI, el proceso cambia ligeramente. Tendrás que cambiar el tipo de proveedor a Azure OpenAI y especificar la versión de la API (por ejemplo, la 2024-02-15-preview) junto con la URL de tu recurso específico en Azure. Un detalle vital aquí es que deberás añadir los nombres de los despliegues en el apartado de IDs de modelo para que el sistema sepa exactamente con qué instancia interactuar.

Integración de proveedores compatibles

Hay un montón de servicios que, aunque no son de OpenAI, usan su misma estructura para que la migración sea pan comido. Aquí tienes los más destacados y cómo configurarlos:

• Anthropic (Claude): Utiliza la URL https://api.anthropic.com/v1. Open WebUI tiene una capa de compatibilidad que detecta los modelos automáticamente, aunque para aprovechar funciones avanzadas como el procesamiento de PDFs o el pensamiento extendido, es preferible su API nativa.
• Google Gemini: Se conecta mediante https://generativelanguage.googleapis.com/v1beta/openai. Solo necesitas tu clave de AI Studio y los modelos se cargarán solos.
• DeepSeek y Mistral AI: Ambos son totalmente compatibles. Para DeepSeek usa https://api.deepseek.com/v1 y para Mistral https://api.mistral.ai/v1. En ambos casos, la detección automática de modelos funciona a la perfección.
• Groq: Si buscas velocidad pura, usa https://api.groq.com/openai/v1. Es ideal para ejecutar Llama 3 o DeepSeek-R1 con una latencia mínima.
• Perplexity: Usa https://api.perplexity.ai. Ojo aquí, que los IDs de los modelos (como sonar-pro) deben añadirse manualmente ya que no se auto-detectan.

Casos especiales: MiniMax y Vercel AI Gateway

Si te interesa el código, MiniMax es una opción brutal. Tras suscribirte a su plan de coding y obtener tu clave, configura la URL https://api.minimax.io/v1. Como no exponen un endpoint de modelos, es obligatorio escribir a mano MiniMax-M2.5 en el filtro de Model IDs para que aparezca en el desplegable.

Por otro lado, si quieres gestionar varios proveedores desde un solo sitio, Vercel AI Gateway es la solución. Con la URL https://ai-gateway.vercel.sh/v1, puedes monitorizar el gasto y el enrutamiento de peticiones hacia distintas IAs desde un panel centralizado, manteniendo la compatibilidad con el formato OpenAI.

Conectando con Amazon Bedrock (AWS)

Llevar Open WebUI a AWS Bedrock es un poco más complejo pero ofrece una robustez profesional. Existen tres rutas principales dependiendo de lo que necesites:

1. Bedrock Access Gateway (BAG)

Es un proxy de AWS que convierte las llamadas de Bedrock al formato de OpenAI. Una vez desplegado con Docker, la URL que debes poner en Open WebUI es http://host.docker.internal:8000/api/v1. Por defecto, la clave API es bedrock, a menos que la hayas cambiado en el archivo de configuración.

2. stdapi.ai

Esta herramienta es un gateway más completo que permite acceso multi-región y soporte para servicios adicionales como Amazon Polly (texto a voz) o Transcribe. Puedes desplegarlo en ECS Fargate o localmente. En Open WebUI, configurarás las variables de entorno o el panel de control usando la URL de tu instancia de stdapi.ai y la clave secreta que definas.

3. Bedrock Mantle

Es la opción más sencilla porque es nativa de AWS y no requiere instalar infraestructura extra. Solo necesitas tu clave API de Bedrock y configurar la URL según tu región (por ejemplo, us-east-1). La limitación es que solo soporta chat completions y un subconjunto de modelos de pesos abiertos.

Trucos avanzados y resolución de errores

A veces, al añadir varias APIs, los modelos pueden llamarse igual y causar confusión. Para evitar esto, usa el Prefix ID en la configuración; por ejemplo, pon groq/ para que el modelo aparezca como groq/llama3 y sepas exactamente qué servidor estás usando.

Si te encuentras con errores de conexión fallida, comprueba que la URL base sea la correcta. Un fallo común es intentar conectar a https://api.openai.com/v1 en la sección de «Herramientas Externas» en lugar de en el apartado de Conexiones OpenAI. Si usas Ollama como backend, recuerda que Open WebUI se comunica con él internamente, pero para APIs externas necesitas una clave válida y un endpoint accesible desde el contenedor.

La versatilidad de Open WebUI reside en su capacidad para actuar como puente entre el usuario y cualquier motor de IA que respete el estándar de OpenAI, permitiendo desde configuraciones locales sencillas con Ollama hasta despliegues empresariales masivos en AWS Bedrock o el uso de modelos especializados en código y razonamiento mediante proxies y gateways inteligentes.