07 - Open WebUI : limiter et organiser les modèles (OpenRouter + Claude)

OpenRouter expose des centaines de modèles. Sans filtrage, le sélecteur d'Open WebUI devient illisible - et n'importe quel utilisateur peut lancer un modèle très cher. Ce guide montre comment limiter la liste, la ranger, et contrôler qui a accès à quoi.

Rappel de l'architecture (voir docs 04 §6 / 06 §5bis) : Open WebUI a 2 connexions - OpenRouter (tous les modèles) et LiteLLM (Claude en direct).

Méthode 1 - Liste blanche sur la connexion (recommandé)

La méthode la plus propre : dire à Open WebUI de ne charger que certains modèles d'une connexion, au lieu de tout importer.

1. Ouvre Open WebUI → Admin (ton avatar) → Settings → Connections.

2. Clique sur la connexion OpenRouter (https://openrouter.ai/api/v1) → ⚙️.

3. Dans le champ Model IDs, ajoute un par un les identifiants exacts des modèles que tu veux, par exemple :

   anthropic/claude-sonnet-4.5
   anthropic/claude-opus-4.1
   openai/gpt-4o
   openai/gpt-4o-mini
   google/gemini-2.5-pro
   google/gemini-2.5-flash
   meta-llama/llama-3.3-70b-instruct
   deepseek/deepseek-chat
   

   (Les IDs exacts sont sur https://openrouter.ai/models - bouton copier à côté du nom de chaque modèle.)

4. Save. Dès qu'au moins un Model ID est renseigné, Open WebUI n'affiche que ceux-là pour cette connexion - les centaines d'autres disparaissent.

La connexion LiteLLM n'a pas ce problème : elle n'expose que les modèles définis dans docker/litellm/config.yaml (3 modèles Claude). C'est déjà une liste blanche par construction.

Méthode 2 - Masquer/activer modèle par modèle

Si tu préfères tout importer puis trier :

1. Admin → Settings → Models : la liste complète apparaît.
2. Chaque modèle a un interrupteur de visibilité - désactive ceux que tu ne veux pas. Tu peux aussi les renommer (ex. « Claude (rapide) ») et leur mettre une description pour les non-IT.
3. Astuce : la barre de recherche + tri permettent de désactiver en masse par fournisseur (« mistral », « qwen », etc.).

C'est plus long que la méthode 1, mais utile pour ajuster finement après coup.

Méthode 3 - Restreindre PAR UTILISATEUR ou groupe

Pour contrôler qui peut utiliser quoi (ex. les non-IT n'ont que 2 modèles) :

1. Admin → Settings → Models → ouvre un modèle → Visibility : Private → choisis les groupes autorisés.
2. Les groupes se gèrent dans Admin → Users → Groups (ex. groupe « équipe », groupe « IT »).
3. Résultat : chaque utilisateur ne voit que les modèles de ses groupes.

Pense aussi à Admin → Settings → Users :

• Default User Role : pending → tout nouveau compte doit être approuvé par toi avant d'accéder au chat (important, l'URL est publique !).
• Enable New Sign Ups : off si tu préfères créer les comptes toi-même.

Méthode 4 - Côté OpenRouter (garde-fous de dépense)

En complément, sur https://openrouter.ai/settings :

• Credits / Limits : mets une limite de crédit sur la clé API utilisée par Open WebUI - même si quelqu'un lance un modèle cher, la dépense est plafonnée.
• Tu peux créer une clé dédiée au VPS (nomme-la openwebui-vps) pour suivre sa consommation séparément et la révoquer sans toucher au reste.
• Settings → Ignored Providers : exclut des fournisseurs entiers si besoin.

Modèle par défaut + presets

• Admin → Settings → Interface → Default Model : choisis le modèle proposé par défaut à tout le monde (ex. anthropic/claude-sonnet-4.5 - bon rapport qualité/prix, ou openai/gpt-4o-mini pour l'économie).
• Tu peux créer des modèles personnalisés (Workspace → Models) : un modèle de base + un system prompt + des réglages, présenté sous un nom métier (ex. « Assistant SAV ENGWE »). Parfait pour les non-IT : ils choisissent « Assistant SAV » sans se soucier du modèle en dessous.

Sélection de départ recommandée

Si tu veux un point de départ simple (6 modèles, du plus économique au plus puissant) :

(+ les 3 Claude directs via LiteLLM : claude-opus-4-8, claude-sonnet-5, claude-haiku-4-5 - facturés sur ton compte Anthropic.)

Les IDs évoluent avec les sorties de modèles - vérifie les noms actuels sur https://openrouter.ai/models avant de coller la liste.

Check-list finale

• Connexion OpenRouter limitée à ~6-10 modèles (Méthode 1)
• Modèle par défaut défini
• Nouveaux comptes en pending (approbation manuelle)
• Limite de crédit posée sur la clé OpenRouter
• (Optionnel) Groupes + modèles privés pour les non-IT