Open WebUI
Open WebUI añade UberLLM como una conexión de OpenAI API.
Antes de empezar
- Una cuenta de UberLLM con crédito, y una API key de
Panel de control → Keys (
ull_...).
Configuración (conexión de administrador, para todos en el servidor)
- Ve a Ajustes → Administrador → Conexiones.
- En Gestionar conexiones de la API de OpenAI, haz clic en ➕ Añadir conexión.
- Rellena:
- URL:
https://api.uberllm.dev/v1 - API Key: tu clave
ull_...(deja el tipo de autenticación en Bearer)
- URL:
- Abre Avanzado (opcional pero recomendado):
- Prefix ID:
uberllm. Los modelos se mostrarán entonces comouberllm.z-ai/glm-5.2, para que nunca choquen con los modelos de tus otras conexiones. Open WebUI elimina el prefijo antes de enviar la solicitud. - Model IDs: añade los modelos que quieras, uno a la vez con + (ver abajo). Con esta lista configurada, Open WebUI muestra solo estos modelos y deja de cargar la lista completa.
- Headers:
{"X-Title": "Open WebUI"}le dice a UberLLM qué aplicación envió la solicitud.
- Prefix ID:
- Deja el Tipo de API en Chat Completions, la configuración probada aquí. UberLLM también sirve la API de respuestas.
- Haz clic en Verificar conexión, luego en Guardar. Guardar por sí solo no prueba nada.
UberLLM lista aproximadamente 450 modelos, incluyendo modelos de imagen y video que no chatean. Sin una lista de Model IDs, cada uno de ellos aparece en el menú y cada carga de página espera la lista completa, así que añade una lista de permitidos (o activa Cache Base Model List).
Configuración con variables de entorno de Docker
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URLS="https://api.uberllm.dev/v1" \
-e OPENAI_API_KEYS="ull_your-key" \
-e OPENAI_API_CONFIGS='{"0":{"prefix_id":"uberllm","model_ids":["deepseek/deepseek-v4.1-flash","google/gemini-2.5-flash","z-ai/glm-5.2"]}}' \
-v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
Estas variables se leen solo en el primer inicio. Después de eso, el valor guardado en
la base de datos de Open WebUI prevalece, a menos que configures ENABLE_PERSISTENT_CONFIG=False. Si ya
ejecutas Open WebUI, usa la pantalla de administración en su lugar.
Conexión directa (cada usuario trae su propia clave)
- El administrador activa Conexiones Directas en Ajustes → Administrador → Conexiones
(o establece
ENABLE_DIRECT_CONNECTIONS=true). - Cada usuario abre Ajustes de Usuario → Conexiones, hace clic en +, e introduce
Base URL
https://api.uberllm.dev/v1y su propia API Key.
Con una conexión directa, el navegador del usuario llama al propio UberLLM y la clave permanece en ese navegador. UberLLM permite estas llamadas del navegador.
Modelos recomendados
Verificado el 30 de octubre de 2026 a través de UberLLM.
| ID del modelo | Contexto | Notas |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | Rápido; razona antes de responder |
google/gemini-2.5-flash |
1,048,576 | Lee imágenes |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | Lee imágenes, responde sin un paso de razonamiento |
Errores comunes
| Lo que ves | Causa y solución |
|---|---|
Verificar conexión falla con 401 |
Clave faltante o mal escrita. |
| No aparecen modelos | La URL tiene una barra final o un error tipográfico. Debe ser exactamente https://api.uberllm.dev/v1. |
| El menú o la página del modelo carga lentamente | Lista de permitidos de Model IDs ausente: ver arriba. |
| Un modelo de otra conexión desapareció | Dos conexiones devolvieron el mismo ID sin prefijo, y Open WebUI mantuvo uno. Configura Prefix ID. |
402 insufficient_credits |
Saldo vacío. Añade crédito en Dashboard → Credits. |