Passer au contenu principal

​
Aperçu

Dify fonctionne bien avec TokenLab grâce à son flux de fournisseur de modèles compatible avec OpenAI. Il s’agit d’un chemin d’intégration orienté vers les complétions de chat. Cela ne doit pas être interprété comme une garantie que Dify expose les mêmes réponses ou le même comportement WebSocket que les intégrations Codex dédiées. Pour les versions actuelles de Dify, le chemin le plus sûr est généralement le suivant :
  • choisir le fournisseur OpenAI intégré
  • définir votre clé API TokenLab
  • définir une URL de base personnalisée https://api.tokenlab.sh/v1
Certaines versions plus anciennes de Dify exposent cela en tant que OpenAI-API-compatible au lieu du fournisseur OpenAI intégré avec un champ d’URL de base personnalisée. Si votre interface Dify semble différente, utilisez le flux de fournisseur personnalisé compatible OpenAI le plus proche disponible dans cette version.
Type : Framework ou PlateformeChemin principal : Chemin de chat compatible OpenAINiveau de support : Supporté avec des limites de périmètre

​
Prérequis

  • Compte TokenLab avec accès API
  • Dify Cloud ou Dify auto-hébergé

​
Étapes de configuration

​
Étape 1 : Obtenir votre clé API

  1. Connectez-vous au Tableau de bord TokenLab
  2. Ouvrez Clés API
  3. Créez ou copiez une clé API commençant par sk-

​
Étape 2 : Configurer le fournisseur

1

Ouvrir les fournisseurs de modèles

Dans Dify, allez dans Paramètres → Fournisseurs de modèles
2

Sélectionner OpenAI

Ouvrez les paramètres du fournisseur OpenAI. Si votre version de Dify ne propose pas d’URL de base personnalisée ici, utilisez plutôt l’option de fournisseur personnalisé compatible OpenAI exposée par cette version.
3

Saisir les paramètres TokenLab

Utilisez ces valeurs :
ChampValeur
Clé APIsk-your-tokenlab-key
URL de base API / URL de base personnaliséehttps://api.tokenlab.sh/v1
4

Ajouter des modèles

Ajoutez les modèles que vous souhaitez utiliser, par exemple :
  • gpt-5.4
  • gpt-5.4-mini
  • claude-sonnet-5
  • claude-opus-4-8
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • deepseek-v4-flash

​
Étape 3 : Tester la connexion

  1. Choisissez un modèle tel que gpt-5-mini ou gpt-4o
  2. Envoyez un prompt de test
  3. Confirmez que Dify reçoit une réponse valide

​
Embeddings pour les bases de connaissances

Pour le RAG et l’indexation de bases de connaissances, ajoutez un modèle d’embedding tel que :
  • text-embedding-3-small
  • text-embedding-3-large
Ensuite, définissez-le comme modèle d’embedding par défaut dans les paramètres de la base de connaissances ou de l’application concernée.

​
Rôles de modèles recommandés

Cas d’utilisationModèles suggérés
Chat par défautgpt-5.4-mini, gpt-5.4, claude-sonnet-5
Raisonnement approfondigpt-5.5, gpt-5.4, claude-opus-4-8, deepseek-v4-pro
Rapide/économiquegpt-5.4-mini, gemini-3.5-flash, deepseek-v4-flash
Embeddingstext-embedding-3-small, text-embedding-3-large

​
Bonnes pratiques

Dans les versions plus récentes de Dify, le fournisseur OpenAI intégré avec une URL de base personnalisée est généralement la configuration la plus propre pour TokenLab.
Utilisez gpt-5.4-mini, gemini-3.5-flash ou deepseek-v4-flash pendant vos itérations, puis basculez les flux de travail plus lourds vers des modèles plus puissants uniquement lorsque nécessaire.
La plupart des flux Dify utilisent un comportement de chat compatible OpenAI. Si vous avez besoin de réponses spécifiques à Codex ou d’un comportement WebSocket, utilisez plutôt les intégrations Codex dédiées.

​
Dépannage

  • Vérifiez que l’URL de base est exactement https://api.tokenlab.sh/v1
  • Supprimez les barres obliques (slashes) finales si Dify les duplique
  • Confirmez que le serveur Dify peut atteindre TokenLab via l’internet public
  • Vérifiez à nouveau la clé API
  • Confirmez que la clé est active dans le tableau de bord TokenLab
  • Assurez-vous que la valeur collée dans Dify ne contient pas d’espaces ou de sauts de ligne supplémentaires
  • Vérifiez exactement le nom du modèle
  • Ajoutez à nouveau l’entrée du modèle si l’interface du fournisseur a mis en cache une ancienne valeur
  • Vérifiez la disponibilité actuelle du modèle dans la documentation ou le tableau de bord TokenLab