Ouvrir la configuration de l'API WebUI

Ajoutez TokenHub à Open WebUI en tant que connexion compatible OpenAI, sélectionnez un modèle et vérifiez une demande de discussion.

Créer une clé API TokenHub

Qu’est-ce qu’Open WebUI ?

Open WebUI est une interface auto-hébergée permettant de discuter avec des modèles d'IA et de connecter des fournisseurs de modèles compatibles OpenAI.

Cette configuration Open WebUI ajoute TokenHub à partir du panneau de connexion administrateur. Il utilise le protocole OpenAI Chat Completions et fournit une liste d'autorisation de modèles manuelle lorsqu'un fournisseur n'expose pas /models. La connexion appartient au panneau de connexion de l'administrateur, où un fournisseur compatible OpenAI peut exposer un ou plusieurs modèles aux utilisateurs. Lorsque la découverte automatique de modèles n'est pas disponible, utilisez la liste verte de modèles au lieu de supposer que le point de terminaison de discussion est défectueux, et testez l'accès au réseau depuis l'intérieur du conteneur Open WebUI lors de l'auto-hébergement avec Docker.

Open WebUI gère les services de modèle par protocole au lieu de nécessiter un plug-in distinct pour chaque fournisseur. Ajoutez TokenHub en tant que OpenAI API Connection. Open WebUI ajoute ensuite /models et /chat/completions à la base API URL.

Ajoutez TokenHub sous Connexions administrateur

Cela fait suite à la séquence officielle Step 1: Add Your Provider Connection de Open WebUI :

  1. Connectez-vous à Open WebUI avec un compte administrateur.
  2. Accédez à Settings → Admin → Connections.
  3. Recherchez Manage OpenAI API Connections et cliquez sur Add Connection (le bouton plus).
  4. Entrez https://us-api.tokenhub.com/v1 dans URL.
  5. Entrez votre clé TokenHub API dans API Key.
  6. Si la vérification de la connexion ne renvoie aucun modèle, entrez un ID de modèle TokenHub exact sous Model IDs (Filter) et cliquez sur le bouton plus pour l'ajouter à la liste verte.
  7. Cliquez sur Save.

Ne mettez pas /chat/completions dans le URL. Open WebUI ajoute lui-même les chemins de requête, donc une requête complète URL crée un chemin dupliqué.

Comprendre Vérifier la connexion et les ID de modèle (Filtre)

Avant l'enregistrement, Open WebUI envoie une demande standard de jeton Bearer au point de terminaison /models du fournisseur. Sa documentation indique que certains services compatibles renvoient 400, 401 ou 403 à cette demande de découverte même si la complétion du chat fonctionne. Testez dans cet ordre :

  1. Ajoutez manuellement l'ID de modèle sous Model IDs (Filter) et enregistrez.
  2. Démarrez une nouvelle discussion et confirmez que le modèle apparaît dans le sélecteur.
  3. Sélectionnez-le et envoyez un message afin de tester une véritable demande de fin de chat.

Ajoutez chaque ID de modèle une seule fois. Open WebUI supprime les espaces environnants. Le commutateur à côté d'une connexion désactive temporairement le fournisseur sans supprimer ses paramètres.

Ne remplacez pas host.docker.internal par un API distant

L'astuce officielle host.docker.internal s'applique uniquement lorsqu'un conteneur Open WebUI doit atteindre un serveur modèle exécuté sur l'hôte Docker. TokenHub est un service distant HTTPS, alors conservez https://us-api.tokenhub.com/v1. Si seul le conteneur expire, inspectez sa résolution DNS, son accès sortant HTTPS et la configuration du proxy plutôt que de remplacer URL par localhost.

Vérifiez la requête que Open WebUI envoie réellement

  1. Créez une discussion et choisissez le modèle TokenHub que vous avez ajouté à la liste verte.
  2. Envoyez d’abord un court message texte uniquement.
  3. Dans les journaux de requêtes TokenHub, confirmez que le chemin est /v1/chat/completions, que l'ID du modèle est exact et que l'utilisation a été enregistrée.
  4. Seulement après les travaux de chat de base, les outils de test, les images et les fonctionnalités de connaissances séparément. Un contrôle dans Open WebUI ne garantit pas que le modèle sélectionné ou le point de terminaison compatible prend en charge cette fonctionnalité.

Pour un 404, confirmez d'abord que le URL se termine à /v1. Si le modèle est manquant, revenez à Model IDs (Filter). Si l'échec se produit uniquement dans Docker, inspectez le réseau de conteneurs.

Référence officielle

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ sur la configuration de l'API WebUI ouverte

Comment ajouter une API compatible OpenAI à Open WebUI ?

Ouvrez Paramètres → Administrateur → Connexions et ajoutez une connexion sous Gérer les connexions API OpenAI. Entrez l'URL TokenHub /v1 et la clé API, puis enregistrez-les.

L’URL Open WebUI doit-elle inclure /chat/completions ?

Non. Utilisez la racine de l'API se terminant par /v1 ; Open WebUI construit le chemin de requête pour chaque opération.

Pourquoi la liste des modèles Open WebUI est-elle vide ?

Si la découverte de modèle n'est pas disponible, ajoutez l'ID de modèle TokenHub exact sous ID de modèle (Filtre), enregistrez et rouvrez le sélecteur de modèle de nouvelle discussion.

Pourquoi Dockerized Open WebUI ne peut-il pas atteindre TokenHub ?

Testez le DNS, le proxy, les certificats et l'accès sortant depuis le conteneur Open WebUI. La connectivité hôte-navigateur ne prouve pas que le conteneur dispose d'un accès au réseau.

Comment puis-je vérifier qu'Open WebUI utilise TokenHub ?

Sélectionnez le modèle configuré dans une nouvelle discussion, envoyez un court message et confirmez l'ID du modèle, l'état et l'utilisation du jeton dans les journaux de requêtes TokenHub.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。