Documentation

Open WebUI

Open WebUI traite tout endpoint compatible avec OpenAI comme une connexion. Ajoutez-en une dans les paramètres d’administration ou définissez deux variables d’environnement au démarrage du conteneur — les deux méthodes aboutissent au même résultat.

Une connexion OpenAI sous Admin Settings, ou OPENAI_API_BASE_URL et OPENAI_API_KEY au démarrage du conteneur — les deux aboutissent au même /v1.

Connexion ou docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Renseignez Model IDs (Filter). Sans cela, le sélecteur affiche tout le catalogue, y compris les modèles d’image, de vidéo et de musique qu’une fenêtre de chat ne peut pas appeler ; le premier clic de l’utilisateur tombe alors sur l’un d’eux. Ce filtre est aussi à utiliser lorsqu’un endpoint n’a pas de route /models ; Kunavo en a une, donc la vérification réussit dans les deux cas.

L’URL conserve le /v1. Si Open WebUI s’exécute dans Docker et que vous le pointez vers un élément situé sur le même hôte, remplacez localhost par host.docker.internal — cela ne s’applique pas à un endpoint hébergé, mais c’est le problème rencontré juste après celui-ci.

Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration Open WebUI.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Dans Open WebUI, accédez à Paramètres → Administration → Connexions, puis repérez Gérer les connexions à l’API OpenAI.
Cliquez sur ➕ Ajouter une connexion, puis saisissez l’URL et la clé API.
Ajoutez les identifiants souhaités à Model IDs (Filter), puis enregistrez et laissez la connexion se vérifier.
Lancez une nouvelle conversation — les modèles apparaissent dans le sélecteur, précédés du nom de la connexion.

Vérifié avec Guide des fournisseurs compatibles avec OpenAI d’Open WebUI le 6 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Open WebUI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Identifiant du modèle	Entrée / sortie sur Kunavo	Où cela s’intègre dans Open WebUI
`claude-sonnet-5`	$1.40 / $7.00	le modèle de chat général par défaut
`claude-opus-5`	$3.50 / $17.50	les longs échanges analytiques
`claude-haiku-4-5`	$0.70 / $3.50	rapide, peu coûteux et adapté à la plupart des tours
`gpt-5-6-terra`	$0.70 / $4.20	les longs documents collés dans la fenêtre de chat

La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

Questions fréquentes

Comment connecter Open WebUI à une API compatible avec OpenAI ?

Accédez à Paramètres → Administration → Connexions, ouvrez « Gérer les connexions à l’API OpenAI », puis cliquez sur Ajouter une connexion. Saisissez ensuite l’URL de l’endpoint — la racine /v1 — et la clé API. Vous pouvez aussi faire la même chose au démarrage du conteneur avec les variables d’environnement OPENAI_API_BASE_URL et OPENAI_API_KEY. Les deux méthodes créent la même connexion.

À quoi sert Model IDs (Filter) dans Open WebUI ?

Ce champ limite les identifiants de modèle de cette connexion qui apparaissent dans le sélecteur. Il sert aussi de solution de repli pour les endpoints qui n’implémentent pas de route /models : vous y ajoutez alors les identifiants manuellement, et la vérification échoue même si le chat fonctionne toujours. Il est conseillé de le renseigner sur une passerelle avec un grand catalogue multimodal, afin que le sélecteur de chat n’affiche que les modèles qu’une fenêtre de chat peut réellement appeler.

L’URL de base d’Open WebUI inclut-elle /v1 ?

Oui. Open WebUI n’ajoute à l’URL indiquée que la route ; l’URL de connexion doit donc être la racine /v1 — https://api.example.com/v1. Les endpoints des propres exemples de la documentation comportent ce suffixe. Sans lui, la connexion s’enregistre, mais chaque requête renvoie une erreur 404.

Open WebUI peut-il utiliser des modèles Claude et GPT ?

Oui, lorsqu’ils sont proposés via un endpoint compatible avec OpenAI. Open WebUI transmet directement l’identifiant du modèle à l’URL de connexion ; les identifiants de n’importe quel fournisseur sont donc résolus par l’endpoint, et non par Open WebUI. Cela signifie également qu’une seule connexion et une seule clé peuvent faire apparaître des identifiants Claude et GPT dans le même sélecteur de modèles.