Open WebUI
Open WebUI aggiunge UberLLM come una connessione OpenAI API.
Prima di iniziare
- Un account UberLLM con credito e una API key da
Dashboard → Chiavi (
ull_...).
Configurazione (connessione amministratore, per tutti sul server)
- Vai su Impostazioni → Amministratore → Connessioni.
- Sotto Gestisci connessioni API OpenAI, clicca su ➕ Aggiungi connessione.
- Compila:
- URL:
https://api.uberllm.dev/v1 - Chiave API: la tua chiave
ull_...(lascia il tipo di autenticazione su Bearer)
- URL:
- Apri Avanzate (opzionale ma raccomandato):
- ID Prefisso:
uberllm. I modelli appariranno quindi comeuberllm.z-ai/glm-5.2, in modo che non entrino mai in conflitto con i modelli delle tue altre connessioni. Open WebUI rimuove il prefisso prima di inviare la richiesta. - ID Modelli: aggiungi i modelli che desideri, uno alla volta con + (vedi sotto). Con questo elenco impostato, Open WebUI mostrerà solo questi modelli e smetterà di caricare l'elenco completo.
- Headers:
{"X-Title": "Open WebUI"}indica a UberLLM quale app ha inviato la richiesta.
- ID Prefisso:
- Lascia Tipo API su Chat Completions, l'impostazione testata qui. UberLLM serve anche la API di Risposte.
- Clicca su Verifica connessione, poi su Salva. Il solo salvataggio non testa nulla.
UberLLM elenca circa 450 modelli, inclusi modelli di immagini e video che non chattano. Senza un elenco di ID Modelli, ognuno di essi appare nel menu e ogni caricamento di pagina attende l'elenco completo, quindi aggiungi una lista di elementi consentiti (o attiva Cache Base Model List).
Configurazione con variabili d'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
Queste variabili vengono lette solo al primo avvio. Dopodiché, il valore salvato nel database di Open WebUI prevale, a meno che tu non imposti ENABLE_PERSISTENT_CONFIG=False. Se Open WebUI è già in esecuzione, usa invece la schermata di amministrazione.
Connessione diretta (ogni utente porta la propria chiave)
- L'amministratore attiva Connessioni Dirette sotto Impostazioni → Amministratore → Connessioni
(o imposta
ENABLE_DIRECT_CONNECTIONS=true). - Ogni utente apre Impostazioni Utente → Connessioni, clicca su +, e inserisce
Base URL
https://api.uberllm.dev/v1e la propria API Key.
Con una connessione diretta il browser dell'utente chiama direttamente UberLLM e la chiave rimane in quel browser. UberLLM consente queste chiamate dal browser.
Modelli consigliati
Verificato il 30 ottobre 2026 tramite UberLLM.
| ID modello | Contesto | Note |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | Veloce; ragiona prima di rispondere |
google/gemini-2.5-flash |
1,048,576 | Legge le immagini |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | Legge le immagini, risponde senza ragionare |
Errori comuni
| Cosa vedi | Causa e soluzione |
|---|---|
Verify Connection fallisce con 401 |
Chiave mancante o digitata male. |
| Nessun modello appare | L'URL ha uno slash finale o un errore di battitura. Deve essere esattamente https://api.uberllm.dev/v1. |
| Il menu o la pagina dei modelli si carica lentamente | Nessuna allow-list di Model IDs: vedi sopra. |
| Un modello da un'altra connessione è scomparso | Due connessioni hanno restituito lo stesso id senza prefisso, e Open WebUI ne ha mantenuto uno. Imposta Prefix ID. |
402 insufficient_credits |
Saldo vuoto. Aggiungi credito sotto Dashboard → Credits. |