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: Bearercontenant 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 :
- URL :
https://api.nofilteraichat.com/v1 - Clé : votre clé API
- 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:mainOuvrez 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 :
- Dans n8n, créez un nouvel identifiant de type OpenAI.
- Collez votre clé API.
- Définissez la Base URL sur
https://api.nofilteraichat.com/v1. - 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
Authorizationet la valeurBearer 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ôme | Cause probable | Correction |
|---|---|---|
| Open WebUI n'affiche aucun modèle | URL ou clé incorrecte | Utilisez l'URL de base se terminant par /v1 ; testez GET /v1/models avec curl |
| Modifications de l'environnement Docker ignorées | Paramètres déjà stockés | Modifiez la connexion dans Paramètres Admin |
| 401 de n8n | Valeur d'en-tête manquant le mot Bearer | La valeur doit être Bearer, un espace, puis la clé |
| Open WebUI dans Docker ne peut pas atteindre un proxy local | localhost pointe vers le conteneur | Utilisez l'adresse de l'hôte, pas localhost |
| 429 au milieu d'une boucle | Trop d'éléments en parallèle | Mettez 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.
