Open WebUI
Open WebUI ajoute UberLLM comme une connexion OpenAI API.
Avant de commencer
- Un compte UberLLM avec du crédit, et une clé API depuis
Tableau de bord → Clés (
ull_...).
Configuration (connexion administrateur, pour tous sur le serveur)
- Allez à Paramètres → Admin → Connexions.
- Sous Gérer les connexions API OpenAI, cliquez sur ➕ Ajouter une connexion.
- Remplissez :
- URL :
https://api.uberllm.dev/v1 - API Key : votre clé
ull_...(laissez le type d'authentification sur Bearer)
- URL :
- Ouvrez Avancé (facultatif mais recommandé) :
- ID de préfixe :
uberllm. Les modèles apparaissent alors commeuberllm.z-ai/glm-5.2, pour qu'ils n'entrent jamais en conflit avec les modèles de vos autres connexions. Open WebUI supprime le préfixe avant d'envoyer la requête. - ID de modèle : ajoutez les modèles que vous souhaitez, un par un avec + (voir ci-dessous). Une fois cette liste définie, Open WebUI n'affiche que ces modèles et arrête de charger la liste complète.
- Headers :
{"X-Title": "Open WebUI"}indique à UberLLM quelle application a envoyé la requête.
- ID de préfixe :
- Laissez le Type d'API sur Chat Completions, le paramètre testé ici. UberLLM sert également l'API de réponses.
- Cliquez sur Vérifier la connexion, puis sur Enregistrer. L'enregistrement seul ne teste rien.
UberLLM liste environ 450 modèles, y compris des modèles d'image et de vidéo qui ne discutent pas. Sans une liste d'ID de modèle, chacun d'eux apparaît dans le menu et chaque chargement de page attend la liste complète, alors ajoutez une liste blanche (ou activez Mettre en cache la liste des modèles de base).
Configuration avec les variables d'environnement 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
Ces variables sont lues uniquement lors du premier démarrage. Après cela, la valeur enregistrée dans la base de données d'Open WebUI prévaut, à moins que vous ne définissiez ENABLE_PERSISTENT_CONFIG=False. Si vous utilisez déjà Open WebUI, utilisez plutôt l'écran d'administration.
Connexion directe (chaque utilisateur apporte sa propre clé)
- L'administrateur active les Connexions directes sous Paramètres → Admin → Connexions
(ou définit
ENABLE_DIRECT_CONNECTIONS=true). - Chaque utilisateur ouvre Paramètres utilisateur → Connexions, clique sur +, et saisit
Base URL
https://api.uberllm.dev/v1et sa propre API Key.
Avec une connexion directe, le navigateur de l'utilisateur appelle UberLLM directement et la clé reste dans ce navigateur. UberLLM autorise ces appels de navigateur.
Modèles recommandés
Vérifié le 30 octobre 2026 via UberLLM.
| ID du modèle | Contexte | Notes |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | Rapide ; raisonne avant de répondre |
google/gemini-2.5-flash |
1,048,576 | Lit les images |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | Lit les images, répond sans étape de raisonnement |
Erreurs courantes
| Ce que vous voyez | Cause et solution |
|---|---|
Vérifier la connexion échoue avec 401 |
Clé manquante ou mal saisie. |
| Aucun modèle n'apparaît | L'URL contient une barre oblique finale ou une faute de frappe. Elle doit être exactement https://api.uberllm.dev/v1. |
| Le menu ou la page des modèles se charge lentement | Pas de liste blanche pour les Identifiants de modèle : voir ci-dessus. |
| Un modèle d'une autre connexion a disparu | Deux connexions ont renvoyé le même ID sans préfixe, et Open WebUI n'en a gardé qu'un. Définissez un ID de préfixe. |
402 insufficient_credits |
Solde vide. Ajoutez du crédit sous Tableau de bord → Crédits. |