n8n en Russie : workflows IA, erreurs et coûts
Connectez BetterToken à n8n, exécutez un workflow IA, limitez les reprises et rapprochez chaque exécution des tokens et frais dans le Dashboard.
Vous voulez tester un workflow IA n8n avec une seule requête contrôlée ? Ouvrez le guide n8n de BetterToken, créez votre propre API Key, puis ajoutez un credential OpenAI dans n8n. Reliez Manual Trigger, AI Agent et OpenAI Chat Model, limitez Max Retries, puis rapprochez l'exécution manuelle de son modèle, statut, usage de tokens et débit dans le BetterToken Dashboard.
Le rôle de n8n dans ce processus IA
n8n gère la séquence des nodes et conserve les données d'exécution. OpenAI Chat Model envoie une requête au modèle choisi, tandis que BetterToken reçoit un appel API compatible OpenAI. Pour le premier test, trois composants suffisent :
Manual Trigger évite un lancement accidentel depuis une planification ou un webhook. L'AI Agent reçoit un prompt fixe et le Chat Model envoie une seule requête au modèle. N'ajoutez ni Telegram, ni e-mail, ni base de données, ni publication, ni autre node ayant des effets externes.
Dans ce schéma, BetterToken fournit l'API Key, la Base URL, le Model ID disponible et le relevé d'usage dans le Dashboard. Cela ne garantit pas la compatibilité de tous les community nodes ou outils hébergés par OpenAI. La connexion au BetterToken API Endpoint depuis la Russie ne requiert pas de VPN ; la disponibilité de n8n Cloud, de votre serveur et des intégrations tierces doit être vérifiée séparément.
Créer un credential sans exposer l'API Key
- Ajoutez le node AI Agent au workflow.
- Dans le connecteur Chat Model, ajoutez le sous-node OpenAI Chat Model.
- Dans Credential to connect with, choisissez Create new credential → OpenAI.
- Si l'interface propose OpenAI Account (ChatGPT) et API Key, choisissez API Key.
Renseignez le credential :
- API Key : votre API Key BetterToken.
- Organization ID : laissez vide.
- Base URL :
https://www.bettertoken.ai/v1. - Add Custom Header : désactivez cette option.
Enregistrez le credential dans le stockage sécurisé de n8n. Ne placez pas la clé dans un prompt, le JSON du workflow, un Code node, une capture d'écran, les données d'exécution ou un dépôt.
Consultez la documentation officielle n8n sur les credentials OpenAI pour les champs et modes d'autorisation actuels.
La Base URL doit se terminer par /v1. N'ajoutez pas /models, /chat/completions ni /responses : n8n complète lui-même l'adresse. Lors de l'enregistrement d'un credential, n8n vérifie les modèles via /models à partir de la Base URL indiquée.
Si la liste des modèles n'apparaît pas, rouvrez le credential et OpenAI Chat Model. Prenez le Model ID exact dans la documentation BetterToken pour n8n ou dans le catalogue de modèles ; cet article ne fige pas un ID dynamique.
Construire un workflow IA minimal
1. Ajouter Manual Trigger
Créez un nouveau workflow et ajoutez Manual Trigger. Ne publiez pas le workflow pendant le test : n8n recommande les exécutions manuelles pendant la construction et les essais.
2. Configurer AI Agent
Reliez Manual Trigger à AI Agent. Dans les options du prompt, choisissez une entrée qui permet de saisir un texte fixe et utilisez :
Ne reliez aucun Tool node. Ce test demande une réponse du modèle, pas une automatisation d'agent.
3. Connecter OpenAI Chat Model
Dans le sous-node OpenAI Chat Model :
- sélectionnez le credential BetterToken créé ;
- sélectionnez le Model ID exact ;
- pour la première requête, désactivez Use Responses API et utilisez Chat Completions ;
- définissez un Timeout final ;
- réglez Max Retries à la valeur minimale permise par la version actuelle de n8n.
Les paramètres Model, Use Responses API, Timeout et Max Retries sont décrits sur la page officielle OpenAI Chat Model.
Responses API et les fonctions intégrées Web Search, File Search ou Code Interpreter ne font pas partie de ce test. Leur présence dans l'interface n8n ne confirme pas leur prise en charge par le modèle ou l'endpoint sélectionné.
4. Exécuter exactement un lancement manuel
Cliquez sur Execute Workflow. Un résultat réussi doit contenir du JSON avec workflow: "n8n" et sum: 4. Si un node renvoie une erreur, ne relancez pas immédiatement : définissez d'abord sa catégorie.
Où consulter le journal d'exécution
Ouvrez Executions pour le workflow actuel et sélectionnez l'exécution manuelle. Vérifiez :
- le statut général de l'exécution ;
- l'heure de début et la durée ;
- l'entrée et la sortie de l'AI Agent ;
- le node où le processus s'est arrêté ;
- le texte d'erreur sans copier le credential ni un prompt sensible.
n8n distingue les exécutions manuelles et de production. Un lancement manuel démarre depuis l'éditeur et convient aux tests ; une exécution de production démarre automatiquement après publication d'un workflow ou depuis un trigger. Laissez le workflow non publié tant que le provider n'est pas vérifié.
Les différences entre les types d'exécution et leurs listes sont expliquées dans la documentation n8n sur les exécutions.
Les données d'exécution peuvent contenir les entrées et sorties d'un node. Pour les workflows sensibles, n8n prend en charge la redaction, qui masque les données tout en conservant les métadonnées telles que le statut, le moment et les noms des nodes. Le prompt de cette instruction ne contient ni donnée personnelle ni secret.
Limiter les reprises et diagnostiquer une erreur
Une reprise automatique n'est utile que pour les erreurs temporaires. Elle crée aussi des requêtes API supplémentaires, ce qui affecte le coût et complique le rapprochement avec une exécution unique.
401/ Unauthorized : ne répétez pas automatiquement ; vérifiez d'abord l'API Key et les espaces superflus.403: ne répétez pas automatiquement ; vérifiez l'accès de la clé au modèle sélectionné.404/ model not found : ne répétez pas automatiquement ; vérifiez la Base URL et le Model ID exact.429: n'autorisez qu'une reprise limitée après une pause ; vérifiez la limite de débit et le nombre de lancements parallèles.5xx/ timeout : ne dépassez pas la limite définie ; vérifiez le statut du provider, le Timeout et la taille du prompt.- Workflow error : ne répétez pas avant le diagnostic ; vérifiez le node, l'expression et les données d'entrée.
Pour le premier test, gardez Max Retries au minimum et n'ajoutez ni boucle, ni Wait + retry, ni error workflow qui déclenche un nouvel appel API. Si une reprise est nécessaire en production, définissez un nombre fini de tentatives et un délai, puis vérifiez combien de requêtes sont apparues dans le Dashboard.
Un n8n error workflow est utile pour signaler un échec, mais la notification elle-même est un effet externe. Ajoutez-le seulement après un contrôle séparé et avec vos propres limites.
Le mécanisme Error Trigger et les données d'une exécution échouée sont décrits dans le manuel officiel de gestion des erreurs.
Vérifier les tokens et le montant dans le Dashboard
Ouvrez le BetterToken Dashboard juste après un lancement manuel. Rapprochez :
- l'heure de démarrage précise dans n8n et l'heure de requête dans le Dashboard ;
- le Model ID d'OpenAI Chat Model et le modèle du relevé d'usage ;
- le statut de réussite ou d'erreur ;
- les tokens d'entrée, de sortie et de cache applicables ;
- le débit correspondant à cet enregistrement.
Ne calculez pas le montant à partir d'un ancien article ou d'un nombre fixe par million de tokens. Le modèle et le prix changent : prenez le débit réel d'un appel dans le Dashboard, et les tarifs actuels sur la page des prix BetterToken.
Si une exécution manuelle correspond à plusieurs lignes dans le Dashboard, vérifiez Max Retries et le comportement de l'agent. Un lancement de workflow visible peut provoquer plusieurs requêtes au modèle, surtout avec une boucle d'agent ou des outils Responses. C'est pourquoi le premier contrôle utilise un prompt fixe, sans outils et avec un minimum de reprises.
Erreurs fréquentes
Le test du credential renvoie 401
Recréez le credential de type OpenAI, retirez les espaces autour de l'API Key et assurez-vous que le mode API Key est choisi, et non OpenAI Account. N'affichez pas la clé dans le journal d'exécution.
Le test du credential ou un node renvoie 404
La Base URL doit être https://www.bettertoken.ai/v1. N'ajoutez ni /models ni endpoint. Rechargez ensuite la liste des modèles et sélectionnez l'ID actuel.
Le chat standard fonctionne, mais pas les outils de l'agent
Revenez au workflow minimal : désactivez Use Responses API, retirez les Tool nodes et répétez un prompt fixe. Vous séparerez ainsi la connexion au provider de la limite spécifique d'un outil ou du workflow.
L'exécution réussit, mais le Dashboard affiche plusieurs requêtes
Vérifiez Max Retries et la boucle de l'agent. Comparez les horodatages et les statuts. N'additionnez pas manuellement les lignes comme un seul appel si n8n a réellement envoyé plusieurs requêtes.
FAQ
Dois-je publier un workflow pour le vérifier ?
Non. Une exécution manuelle depuis l'éditeur suffit. La publication active des triggers de production et peut lancer des actions externes sans confirmation supplémentaire.
Puis-je utiliser la Responses API ?
Uniquement après une vérification séparée du modèle et de l'endpoint choisis. Pour la première connexion, utilisez les Chat Completions ordinaires sans outils OpenAI intégrés.
Où l'API Key BetterToken est-elle stockée ?
Dans le credential n8n de type OpenAI. Ne la dupliquez pas dans les paramètres des nodes, le JSON du workflow, le prompt ou le dépôt.
Comment connaître le coût réel d'un workflow ?
Exécutez un lancement manuel avec un minimum de retries, puis rapprochez l'heure d'exécution, le Model ID et le statut de l'entrée dans le BetterToken Dashboard. Prenez les tokens et la consommation dans cet enregistrement, et non dans un exemple estimé.