FR ▾
Obtenir une clé API

Open WebUI et n8n : connectez le chat à une API sans censure

Open WebUI vous offre une fenêtre de chat, n8n vous offre l'automatisation, et les deux peuvent utiliser le même endpoint compatible OpenAI. Voici comment configurer chacun, et comment discuter depuis un workflow n8n.

Mis à jour le

Fenêtre de chat et tableau de workflow reliés par un câble à un seul serveur API, montrant Open WebUI et n8n partageant un endpoint

Points clés

  1. Dans Open WebUI, ajoutez l'URL de base et la clé sous Paramètres Admin, Connexions, ou définissez deux variables d'environnement dans Docker.
  2. Dans n8n, soit remplacez l'URL de base dans l'identifiant OpenAI, soit utilisez un nœud HTTP Request.
  3. Utilisez l'ID de modèle uncensored dans les deux outils.
  4. Maintenez les boucles n8n sous 8 requêtes simultanées et activez la nouvelle tentative pour les réponses 429.

Ce que vous configurez

Si vous êtes arrivé ici en tapant openwebui how to chat n8n, vous essayez probablement de faire deux choses liées : discuter avec un modèle dans Open WebUI, et appeler le même modèle depuis des workflows n8n. Les deux outils peuvent pointer vers n'importe quel serveur suivant le format de complétion de chat OpenAI, donc un compte couvre les deux.

Open WebUI est une interface de chat auto-hébergée. n8n est un outil d'automatisation de workflow où vous connectez des nœuds. L'API derrière eux est la même dans chaque cas :

  • URL de base : https://api.nofilteraichat.com/v1
  • ID du modèle : uncensored
  • Auth : un en-tête Authorization: Bearer contenant votre clé

Il vous faut d'abord une clé. La page des clés API vous guide vers l'inscription et le crédit d'essai gratuit de 0,50 $ en un clic, suffisant pour tester tout ce qui suit.

Partie un : Open WebUI

Option A : le panneau admin

Si Open WebUI est déjà en cours d'exécution, connectez-vous en tant qu'admin et ouvrez les Paramètres Admin, puis Connexions. Ajoutez une nouvelle connexion API OpenAI avec ces valeurs :

  1. URL : https://api.nofilteraichat.com/v1
  2. Clé : votre clé API
  3. Enregistrez, puis utilisez le bouton de vérification si votre version en dispose.

Les noms des menus varient légèrement entre les versions ; cherchez la section listant les connexions de style OpenAI. Après avoir enregistré, lancez une nouvelle conversation et ouvrez le sélecteur de modèles. Le modèle uncensored doit apparaître, car Open WebUI charge la liste via GET /v1/models.

Option B : variables d'environnement dans Docker

Si vous démarrez à neuf, transmettez les paramètres lors du lancement du conteneur :

docker run -d --name open-webui -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.nofilteraichat.com/v1" \
  -e OPENAI_API_KEY="$NOFILTER_API_KEY" \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

Ouvrez http://localhost:3000, créez le premier compte local et le modèle sera disponible dans le sélecteur. Notez qu'Open WebUI enregistre les paramètres de connexion dans sa base de données après le premier lancement. Si vous modifiez les variables par la suite et que rien ne change, modifiez la connexion dans le panneau d'administration.

Réglage d'un chat

Dans les contrôles de conversation, vous pouvez définir la température, le top_p, une séquence d'arrêt et un prompt système. Ces paramètres sont transmis au modèle. Pour la fiction et le jeu de rôle, une température entre 0,7 et 1,0 donne un style plus vivant. Pour les questions factuelles, baissez cette valeur. Si le modèle commence à répéter des phrases, augmentez légèrement la pénalité de fréquence.

Partie deux : n8n avec le nœud OpenAI

n8n dispose d'un module d'identification OpenAI natif. Sa configuration inclut un champ Base URL, qui pointe par défaut vers le serveur officiel. Modifiez-le pour que le nœud communique avec votre endpoint :

  1. Dans n8n, créez un nouvel identifiant de type OpenAI.
  2. Collez votre clé API.
  3. Définissez la Base URL sur https://api.nofilteraichat.com/v1.
  4. Enregistrez et attachez l'identifiant à un nœud Chat Model OpenAI ou à un workflow AI Agent.

Le piège est le champ modèle. Certains nœuds affichent un menu déroulant rempli à partir de la liste des modèles, et d'autres limitent les choix aux noms connus. Si vous ne pouvez pas sélectionner uncensored, passez le champ en mode expression et saisissez l'ID à la main. Si votre version de n8n le refuse toujours, utilisez l'approche requête HTTP dans la section suivante, qui n'a pas cette restriction.

Une fois l'identification fonctionnelle, vous pouvez attacher le modèle de chat à un nœud AI Agent et lui attribuer des outils. L'appel de fonctions est pris en charge par l'API (tools, tool_choice, et les résultats sous la forme role: "tool"). Comme pour tout modèle à poids ouverts, testez l'agent sur des entrées réelles et gardez les descriptions d'outils courtes et littérales.

Partie trois : discuter depuis un nœud HTTP Request

L'option la plus prévisible est un nœud HTTP Request simple. Il affiche exactement ce qui est envoyé et fonctionne avec toutes les versions de n8n. Configurez le nœud comme suit :

  • Méthode : POST
  • URL : https://api.nofilteraichat.com/v1/chat/completions
  • Authentification : Header Auth, avec le nom Authorization et la valeur Bearer YOUR_KEY (stockez-la dans un secret, pas dans le nœud)
  • Envoyer le corps : activé, type de contenu JSON

Définissez le corps sur ce qui suit, en utilisant une expression pour le texte utilisateur :

{
  "model": "uncensored",
  "messages": [
    { "role": "system", "content": "You are a concise story assistant for adult fiction writers." },
    { "role": "user", "content": "{{ $json.prompt }}" }
  ],
  "temperature": 0.8,
  "max_tokens": 600
}

Le texte de la réponse se trouve à choices[0].message.content. Dans le nœud suivant, lisez-le avec l'expression {{ $json.choices[0].message.content }}. La même réponse contient également un bloc usage, vous permettant de journaliser les compteurs de tokens dans une feuille de calcul ou une base de données.

Un workflow typique est un déclencheur webhook, ce nœud HTTP, et un nœud de réponse qui renvoie le texte. Un autre cas courant lit des lignes d'une feuille de calcul, génère une ébauche pour chacune, et écrit les résultats à nouveau. Vous pouvez également tester la demande en dehors de n8n d'abord avec curl :

curl https://api.nofilteraichat.com/v1/chat/completions \
  -H "Authorization: Bearer $NOFILTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Limites, tentatives et lots dans n8n

Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute ; une clé d'essai permet 2 et 60. n8n peut facilement dépasser ces chiffres, car un nœud traite chaque élément entrant et peut les déclencher rapidement.

Dans le nœud HTTP Request, ouvrez Options et utilisez le lot : définissez une taille de lot de 4 ou 6 et un intervalle d'une à deux secondes. Dans les paramètres du nœud, activez Retry On Fail avec 3 tentatives et un délai d'attente de 5000 ms. Cela correspond au comportement de l'API : en cas de surcharge brève, elle renvoie un HTTP 429 avec un en-tête Retry-After: 5. Les autres codes 429 indiquent la limite atteinte : rate_limited signifie trop de requêtes par minute, concurrency signifie trop de requêtes simultanées.

Le streaming mérite une note. Une requête en streaming conserve son slot de concurrence jusqu'à la fin du flux. Dans n8n, désactivez le streaming dans le nœud HTTP, car le workflow attend la réponse complète. Open WebUI utilise le streaming par défaut, ce qui est adapté à une fenêtre de chat.

Coût d'un workflow

Supposons qu'un workflow traite 500 lignes, envoyant 800 tokens d'entrée et recevant 250 tokens de sortie pour chacune. Entrée : 500 × 800 = 400 000 tokens, ce qui coûte 400 000 × 0,15 $ / 1 000 000 = 0,06 $. Sortie : 500 × 250 = 125 000 tokens, ce qui coûte 125 000 × 0,50 $ / 1 000 000 = 0,0625 $. Le total de l'exécution est de 0,1225 $, soit environ 12 cents. Consultez la page tarification pour les recharges.

Dépannage

SymptômeCause probableCorrection
Open WebUI n'affiche aucun modèleURL ou clé incorrecteUtilisez l'URL de base se terminant par /v1 ; testez GET /v1/models avec curl
Modifications de l'environnement Docker ignoréesParamètres déjà stockésModifiez la connexion dans Paramètres Admin
401 de n8nValeur d'en-tête manquant le mot BearerLa valeur doit être Bearer, un espace, puis la clé
Open WebUI dans Docker ne peut pas atteindre un proxy locallocalhost pointe vers le conteneurUtilisez l'adresse de l'hôte, pas localhost
429 au milieu d'une boucleTrop d'éléments en parallèleMettez en lot le nœud HTTP et activez la nouvelle tentative
Modèle non trouvéNom mal orthographiéLe seul ID est uncensored

Pensez aux limites du produit lors de la conception d'un workflow : chat textuel uniquement, une fenêtre de contexte de 100 000 tokens partagée entre le prompt et la réponse, et un corps de requête limité à 8 Mo. Il n'existe pas d'endpoint d'embeddings ; conservez toute recherche vectorielle sur un autre service. La page démarrage rapide contient la référence complète des requêtes, et le guide d'intégration couvre davantage de frontends. Les prompts envoyés via l'API ne sont pas utilisés pour l'entraînement.

La règle stricte s'applique dans chaque outil : pas de contenu sexuel impliquant des mineurs. Dans le cadre d'une utilisation adulte légale, le modèle est ajusté pour répondre sans refus de contenu, ce qui convient aux applications de fiction, de jeu de rôle et de compagnon pour adultes.

Questions et réponses

Comment ajouter un endpoint OpenAI personnalisé à Open WebUI ?

Allez dans Paramètres d'administration, Connexions, ajoutez une connexion API OpenAI avec l'URL de base et votre clé. Ou définissez OPENAI_API_BASE_URL et OPENAI_API_KEY au démarrage du conteneur Docker.

n8n peut-il utiliser une URL de base différente pour les nœuds OpenAI ?

Oui. Les identifiants OpenAI ont un champ URL de base. Si la liste déroulante des modèles rejette uncensored, tapez-le en mode expression ou utilisez un nœud Requête HTTP.

Pourquoi ma boucle n8n renvoie-t-elle des erreurs 429 ?

Vous envoyez plus de 8 requêtes simultanées ou plus de 300 par minute avec une clé principale. Ajoutez un lot au nœud HTTP et activez la nouvelle tentative en cas d'échec.

Puis-je utiliser la même clé dans Open WebUI et n8n simultanément ?

Oui, mais les deux outils partagent une limite de 8 requêtes concurrentes, donc gardez les lots de workflow petits pendant que vous discutez.

Votre clé est à une étape du formulaire

Créez un compte, copiez la clé, modifiez l'URL de base. C'est tout ce qu'il faut configurer.

Obtenir une clé API