Open WebUI com UberLLM: todos os modelos de uma conexão
No Open WebUI vá para Configurações › Admin › Conexões, adicione uma conexão de API OpenAI com a URL https://api.uberllm.dev/v1,, autenticação Bearer e sua chave UberLLM, mantenha o Tipo de API em Chat Completions, verifique e salve. Para uma nova instalação Docker, passe OPENAI_API_BASE_URL e OPENAI_API_KEY em vez disso.
Passos (instalação existente)
- Crie uma chave na sua página de chaves e adicione crédito.
- Faça login no Open WebUI como administrador e vá para Configurações › Administrador › Conexões.
- Em Gerenciar Conexões da API OpenAI, clique em + Adicionar Conexão.
- Preencha:
- Tipo de Conexão: Externa
- URL:
https://api.uberllm.dev/v1 - Autenticação: Bearer
- API Key: sua chave
ull_… - Tipo de API: Chat Completions
- Clique em Verificar Conexão, depois em Salvar.
- Abra um novo chat. O seletor de modelos agora lista os modelos do UberLLM.
Passos (nova instalação Docker)
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL=https://api.uberllm.dev/v1 \
-e OPENAI_API_KEY=ull_your_key \
-v open-webui:/app/backend/data \
--name open-webui --restart always \
ghcr.io/open-webui/open-webui:main
Essas variáveis só se aplicam na primeira vez que o Open WebUI inicia. Depois disso, o valor salvo em seu banco de dados prevalece, então em uma instalação que já foi executada, use a tela acima (ou inicie-o uma vez com RESET_CONFIG_ON_START=true).
Para manter sua conexão OpenAI atual e adicionar o UberLLM ao lado dela, use as variáveis no plural com um ponto e vírgula entre as entradas:
-e OPENAI_API_BASE_URLS="https://api.openai.com/v1;https://api.uberllm.dev/v1" \
-e OPENAI_API_KEYS="sk-your-openai-key;ull_your_key"
Uma lista de modelos organizada
UberLLM tem centenas de modelos. Duas configurações em Avançado na conexão mantêm o seletor curto:
- IDs de Modelo: liste apenas os IDs que você deseja, por exemplo
deepseek/deepseek-v4.1-flashegoogle/gemini-3.5-flash. O Open WebUI então mostra apenas esses. - ID de Prefixo: uma palavra como
uberllmé adicionada na frente de cada nome de modelo (uberllm.deepseek/deepseek-v4.1-flash), para que você possa diferenciá-los de outras conexões. Ele é removido antes que a requisição seja enviada.
Solução de Problemas
- Falha na verificação: verifique se a URL termina em
/v1sem nada depois e se a chave não tem espaço. - Lista de modelos carrega lentamente ou está vazia: Open WebUI dá à lista 10 segundos por padrão. Adicione os IDs em Model IDs para que pare de buscar a lista completa, ou aumente
AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST. - Variáveis Docker alteradas e nada aconteceu: veja a nota de primeira inicialização acima.
- 402 créditos insuficientes: adicione crédito na página de créditos.
- Texto chega em rajadas atrás do seu próprio nginx: desative o proxy buffering para Open WebUI.
- Documentos e pesquisa na web: Open WebUI cria embeddings com seu próprio modelo local por padrão, que é o que você quer; UberLLM não serve embeddings.
Continue lendo
- Página de referência: Documentação do Open WebUI
- Configuração do LibreChat
- Todos os modelos com preços em tempo real