Skip to main content
Pour connecter n8n à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

​
Paramètres principaux

​
Prérequis

​
Exigences supplémentaires

  • Une instance n8n Cloud ou auto-hébergée
Conservez /v1 à la fin de la Base URL. N’ajoutez pas /chat/completions ni /responses ; n8n ajoute la route requise par le nœud.

​
Installation

Installez ou ouvrez n8n, puis poursuivez avec la configuration manuelle ci-dessous.

​
Configuration manuelle

Effectuez cette configuration dans l’interface de configuration des nœuds n8n. Vous n’avez pas besoin de modifier de fichier de configuration n8n.

​
Configuration

1

Ajouter AI Agent et OpenAI Chat Model

Ouvrez un workflow et ajoutez un nœud AI Agent. Sur son connecteur Chat Model, ajoutez le sous-nœud OpenAI Chat Model.Ce guide utilise OpenAI Chat Model parce qu’il fournit la connexion de modèle aux n8n AI Agents, chaînes et autres workflows d’IA.
2

Créer une credential OpenAI

Dans OpenAI Chat Model, ouvrez Credential to connect with, sélectionnez Create new credential et choisissez OpenAI.Si votre version de n8n propose OpenAI Account (ChatGPT) et API Key, choisissez API Key. L’authentification OpenAI Account est destinée à un compte officiel, pas à une Base URL BetterToken personnalisée.
3

Saisir la credential BetterToken

Utilisez ces valeurs :Cliquez sur Save. n8n teste cette credential sur /models sous la Base URL configurée ; l’URL complète de test est donc https://www.bettertoken.ai/v1/models.
4

Sélectionner un modèle

Revenez à OpenAI Chat Model, ouvrez Model et sélectionnez le model ID d’un fournisseur compatible indiqué dans le model plaza.Si la liste ne se met pas à jour après l’enregistrement de la credential, rouvrez le nœud ou la credential et rechargez la liste des modèles.
5

Choisir Chat Completions ou Responses

Pour le premier test, laissez Use Responses API désactivé et réalisez une conversation simple dans le mode Chat Completions par défaut.Activez Use Responses API uniquement si votre workflow le nécessite. n8n documente les outils intégrés tels que Web Search, File Search et Code Interpreter pour OpenAI Chat Model + AI Agent avec Responses activé. Ces outils hébergés par OpenAI ne constituent pas automatiquement des capacités confirmées pour BetterToken ; testez-les avec le modèle et l’endpoint sélectionnés.
6

Exécuter un test

Donnez une entrée simple à AI Agent :
Cliquez sur Execute step ou exécutez le workflow. La configuration est terminée lorsque le nœud renvoie une réponse de modèle.

​
Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

​
Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.

​
Erreurs courantes

​
Le test de credential renvoie 401

  • Vérifiez que l’API Key est complète et ne contient pas d’espaces superflus
  • Confirmez que la Key utilise un Model ID du fournisseur compatible
  • Vérifiez l’état de la Key et le solde dans le Dashboard BetterToken

​
Le test de credential renvoie 404

  • La Base URL doit être https://www.bettertoken.ai/v1
  • N’utilisez pas https://www.bettertoken.ai/v1/models comme Base URL
  • N’ajoutez pas /chat/completions ni /responses

​
La liste Model est vide

  • Enregistrez à nouveau la credential, puis rouvrez Model
  • Confirmez que l’API Key peut accéder à https://www.bettertoken.ai/v1/models
  • Copiez un model ID actuel du model plaza ; n’utilisez pas d’ID retiré ou mal orthographié

​
Le chat simple fonctionne, mais les appels d’outils Agent échouent

Désactivez Use Responses API et tous les outils intégrés, puis vérifiez Chat Completions simple. Activez les outils Agent un par un pour déterminer si le problème vient de la capacité du modèle, des arguments de l’outil ou de la configuration du workflow.

​
La Request expire

Augmentez Timeout dans OpenAI Chat Model > Options et conservez une valeur limitée pour Max Retries. Ne réessayez pas à répétition les erreurs 400, 401 ou de configuration.

​
Configuration avancée

​
Fournisseurs compatibles

Les états concernent la méthode de configuration de BetterToken décrite sur cette page.
  • Configuration manuelle : saisissez l’API Key, la Base URL et le Model.
  • Non compatible : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.

​
Guides associés

​
Détails techniques

Cette configuration utilise https://www.bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.

​
Portée

Ce guide confirme uniquement LLM Chat via le protocole OpenAI compatible. Ne configurez pas un modèle de chat GPT comme modèle d’embedding, de rerank, de speech ou d’image.