Skip to main content
Pour connecter Dify à 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

  • Dify Cloud ou une instance Dify auto-hébergée avec les plugins activés
  • L’autorisation d’installer des plugins de modèles et de gérer les modèles de l’espace de travail
Ce guide configure uniquement LLM Chat. N’ajoutez pas un modèle de chat GPT comme Text Embedding, Rerank, Speech-to-Text ou Text-to-Speech.

​
Installation

​
Installer le plugin de modèle OpenAI compatible

1

Ouvrir Model Providers

Dans l’espace de travail Dify, ouvrez Integrations > Model Providers.
2

Installer le plugin officiel

Cliquez sur Install model providers, recherchez OpenAI-API-compatible et installez-le.Dify gère les fournisseurs de modèles comme des plugins au niveau de l’espace de travail. Après l’installation, les applications disposant des autorisations requises peuvent sélectionner les modèles de ce fournisseur.
3

Ajouter un modèle personnalisé

Sur la carte OpenAI-API-compatible, cliquez sur Add Model. Si la carte affiche d’abord Setup ou Configure, ouvrez-le puis choisissez l’option d’ajout de modèle.

​
Configuration manuelle

Effectuez cette configuration dans l’interface de fournisseur de modèles Dify. Vous n’avez pas besoin de modifier de fichier de configuration.

​
Saisir la configuration du modèle

Utilisez ces valeurs pour le premier modèle :
Saisissez uniquement https://www.bettertoken.ai/v1 comme API Base URL. N’ajoutez pas /chat/completions ; le plugin Dify appelle l’endpoint requis.
Utilisez des valeurs prudentes pour les autres capacités facultatives :
  • Thinking Mode Support : activez-le uniquement après avoir confirmé la prise en charge du modèle
  • Stream function calling : sélectionnez Not Support pour le premier test
  • Vision Support : activez-le uniquement si le modèle et l’endpoint acceptent tous deux les entrées d’image
  • Structured Output : laissez-le désactivé tant que le chat simple ne fonctionne pas
Cliquez sur Save. Dify valide l’API Key, la Base URL et le model ID.

​
Utiliser le modèle dans une application

1

Créer ou ouvrir une application Dify

Ouvrez un Chatbot, Agent, Chatflow ou Workflow.
2

Sélectionner le modèle

Dans le sélecteur de modèle de l’application ou un nœud LLM, choisissez le modèle ajouté sous OpenAI-API-compatible.
3

Tester d’abord le chat simple

Exécutez la première Request avec une courte saisie de texte, sans outils ni images :
4

Activer ensuite les capacités Agent

Une fois le chat simple fonctionnel, modifiez la configuration du modèle si vous avez besoin d’appels d’outils. Réglez Function Call Type sur le mode pris en charge par le modèle. Les appels d’outils OpenAI compatibles utilisent généralement Tool Call, mais vous devez vérifier la prise en charge du modèle et de l’endpoint sélectionnés.

​
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. Dify enregistre la configuration personnalisée par model ID. Pour ajouter un autre modèle d’un fournisseur compatible, cliquez à nouveau sur Add Model sous le même fournisseur. Utilisez le nouvel ID pour Model Name et model name for API endpoint. Vous pouvez réutiliser la Base URL et l’API Key.

​
Erreurs courantes

​
L’enregistrement renvoie 401

  • Vérifiez que l’API Key est complète
  • Confirmez que le Model ID provient du fournisseur compatible
  • Vérifiez l’état de la Key et le solde dans le Dashboard BetterToken

​
L’enregistrement renvoie 404

  • L’API Base URL doit être https://www.bettertoken.ai/v1
  • N’ajoutez pas /chat/completions
  • Vérifiez que model name for API endpoint correspond exactement à l’ID du model plaza

​
Dify indique model not found

Model Name peut affecter la façon dont Dify affiche et sélectionne le modèle. Le modèle réellement utilisé pour la Request est contrôlé par model name for API endpoint. Utilisez le même model ID d’un fournisseur compatible dans les deux champs.

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

Rétablissez Function Call Type sur Not Support et vérifiez un nœud LLM de base. Ne le passez à Tool Call que si le modèle sélectionné prend en charge les appels d’outils, puis testez à nouveau les arguments de l’outil.

​
Knowledge ne peut pas utiliser ce modèle comme Embedding Model

Ce comportement est attendu. Un LLM de chat ne peut pas remplacer un modèle d’embedding. Ce guide ne confirme pas d’endpoint BetterToken d’embedding ou de rerank pour Dify ; configurez séparément un fournisseur d’embedding compatible pour Knowledge.

​
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.