Open WebUI

Open WebUI adiciona UberLLM como uma conexão OpenAI API.

Antes de começar

• Uma conta UberLLM com crédito, e uma API key de Dashboard → Chaves (ull_...).

Configuração (conexão de administrador, para todos no servidor)

1. Vá para Configurações → Admin → Conexões.
2. Em Gerenciar Conexões de API OpenAI, clique em ➕ Adicionar Conexão.
3. Preencha:
   • URL: https://api.uberllm.dev/v1
   • API Key: sua chave ull_... (deixe o tipo de autenticação em Bearer)
4. Abra Avançado (opcional, mas recomendado):
   • Prefix ID: uberllm. Os modelos então aparecem como uberllm.z-ai/glm-5.2, para que nunca entrem em conflito com modelos de suas outras conexões. O Open WebUI remove o prefixo antes de enviar a solicitação.
   • Model IDs: adicione os modelos que deseja, um por vez com + (veja abaixo). Com esta lista definida, o Open WebUI mostra apenas esses modelos e para de carregar a lista completa.
   • Headers: {"X-Title": "Open WebUI"} informa ao UberLLM qual aplicativo enviou a solicitação.
5. Deixe API Type em Chat Completions, a configuração testada aqui. O UberLLM também serve a API de Respostas.
6. Clique em Verificar Conexão, depois Salvar. Salvar sozinho não testa nada.

O UberLLM lista cerca de 450 modelos, incluindo modelos de imagem e vídeo que não conversam. Sem uma lista de Model IDs, cada um deles aparece no menu e cada carregamento de página espera pela lista completa, então adicione uma lista de permissões (ou ative Armazenar em Cache Lista de Modelos Base).

Configuração com variáveis de ambiente 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

Essas variáveis são lidas apenas na primeira inicialização. Depois disso, o valor salvo no banco de dados do Open WebUI prevalece, a menos que você defina ENABLE_PERSISTENT_CONFIG=False. Se você já executa o Open WebUI, use a tela de administração em vez disso.

Conexão direta (cada usuário traz sua própria chave)

1. O administrador ativa Conexões Diretas em Configurações → Admin → Conexões (ou define ENABLE_DIRECT_CONNECTIONS=true).
2. Cada usuário abre Configurações do Usuário → Conexões, clica em +, e insere Base URL https://api.uberllm.dev/v1 e sua própria API Key.

Com uma conexão direta, o navegador do usuário chama o próprio UberLLM e a chave permanece naquele navegador. O UberLLM permite essas chamadas de navegador.

Modelos recomendados

Verificado em 30 de outubro de 2026 via UberLLM.

Erros comuns