Intégration de Dify

Documentation maintenue par 1ZheAI. Sources et corrections.

Vous avez trouvé une erreur ? Contactez l’assistance en indiquant l’adresse de la page et une description. N’envoyez pas de clés API ni d’identifiants de compte.

Les utilisateurs de Dify peuvent configurer l’interface compatible OpenAI de 1折AI via le plugin officiel de modèle OpenAI-API-compatible. Vérifiez d’abord un modèle de texte, puis utilisez-le dans un flux de travail ; n’installez pas de plugin tiers provenant d’une source non vérifiée.

Préparation

• Un espace de travail Dify permettant d’installer des plugins de modèle.
• Votre propre clé API 1折AI, ainsi que les ID de modèles que cette clé est autorisée à appeler. Consultez-les dans laconsole.
• Un solde disponible suffisant sur votre compte. La requête de validation lors de l’enregistrement du modèle et les tests d’application peuvent entraîner des frais API normaux.

N’envoyez jamais la clé complète au support client, ne l’inscrivez pas dans la documentation d’un flux de travail, ne la capturez pas dans une capture d’écran ni ne la publiez dans un dépôt public. Enregistrez-la uniquement dans le champ de clé API Key de Dify ; si vous utilisez un Dify hébergé par un tiers, cette instance détiendra votre clé et transmettra les requêtes.

Ajouter un modèle

1. Dans le marché de plugins Dify, trouvez OpenAI-API-compatible et vérifiez que l’éditeur est langgenius.
2. Ouvrez les paramètres de l’espace de travail, allez dans les fournisseurs de modèles, trouvez ce plugin et ajoutez un modèle LLM.
3. Remplissez selon le tableau ci-dessous, puis enregistrez. Les intitulés de l’interface peuvent varier selon la version de Dify.

Champ	Mode de remplissage
Model Name / Nom du modèle	Copiez l’ID de modèle complet depuis la console 1折AI ; ne le remplacez pas par le nom d’affichage
API Key	Votre propre clé 1折AI
API Base URL	https://1zheai.com/v1
Completion mode / Type de conversation	Chat
Nom du modèle dans l’API endpoint	Laissez vide en général ; si défini, il doit correspondre exactement à l’ID de modèle réel
Model context size	Renseignez selon la capacité réelle du modèle choisi ; ne recopiez pas la longueur de contexte d’un autre modèle

Ici, il faut /v1 ; n’inscrivez pas l’adresse complète /v1/chat/completions et ne la dupliquez pas en /v1/v1. N’appliquez pas les instructions d’autres clients qui ne renseignent que l’adresse racine.

Commencer dès la première conversation

Créez une application de chat vide, sélectionnez le modèle que vous venez d’enregistrer, puis saisissez « Présente en une phrase ce que tu sais faire » en chinois. Une fois le texte complet renvoyé, vérifiez ensuite la sortie en flux.

Dans les journaux d’appels de la console 1折AI, vérifiez l’heure de la requête correspondante, le modèle et le résultat. Ne vous basez pas uniquement sur le « Enregistré avec succès » de Dify pour conclure que l’application est connectée. Après le premier succès, configurez les appels d’outils, les entrées visuelles ou la recherche dans la base de connaissances ; ces capacités dépendent du modèle et de l’interface précis et ne doivent pas être considérées comme toutes disponibles au seul motif que la conversation en texte a réussi.

Importer un Chatflow d’exemple

Téléchargez le modèle de Chatflow sans clé, puis dans Dify Studio, choisissez Create → Import DSL file pour l’importer. Le modèle est User Input → LLM → Answer, version DSL 0.7.0, et utilise le plugin compatible officiel 0.0.68.

Ajoutez d’abord vos propres identifiants selon les étapes ci-dessus. Après l’import, ouvrez le nœud LLM et vérifiez que votre fournisseur et votre modèle sont sélectionnés, et non les modèles d’essai de Dify. L’ID de modèle d’exemple est claude-haiku-4-5-20251001 ; si ce modèle n’est pas disponible sur votre compte, remplacez-le par un modèle auquel vous avez accès et vérifiez les paramètres de capacités. Le modèle ne contient pas de clé API et ne fournit aucun quota d’appels gratuit.

Questions fréquentes

Symptôme	À vérifier en premier
503 / No available accounts	L’amont actuel est peut-être limité ou sans capacité disponible. Consultez d’abord l’état du service et les journaux d’appels, réessayez plus tard avec une limite raisonnable ou contactez le support ; ne réessayez pas en continu à haute fréquence et ne régénérez pas la clé à répétition
401 / Clé invalide	Y a-t-il des espaces en trop, la clé a-t-elle été révoquée, et une clé d’une autre plateforme a-t-elle été utilisée par erreur ?
404	L’Base URL est-il exactement https://1zheai.com/v1 ; l’ID de modèle existe-t-il ?
Modèle sans permission ou quota insuffisant	Les restrictions de modèle de la clé actuelle, le solde disponible du compte et le modèle choisi
Enregistrement réussi, mais l’application ne peut pas appeler	L’application a-t-elle sélectionné le bon fournisseur et le bon modèle ; le serveur de l’espace de travail peut-il accéder à l’API ?
Réponses normales, flux anormal	Vérifiez le support SSE du proxy, la version du plugin et le paramètre d’usage en flux ; conservez l’erreur masquée pour le dépannage
Échec des appels d’outils ou de la vision	Vérifiez d’abord que le modèle choisi prend réellement en charge cette capacité ; n’activez pas de force en modifiant seulement le commutateur du plugin

Les requêtes d’un Dify auto-hébergé proviennent de son serveur ; le fait que votre navigateur puisse ouvrir le site officiel ne signifie pas que le serveur Dify peut se connecter à l’API.

Obtenir de l’aide pour l’intégration

Fournissez via le service client en ligne du site officiel la version de Dify, la version du plugin, l’ID de modèle, l’heure de l’erreur, l’ID de requête et l’erreur masquée. N’envoyez pas la clé complète, les données clients ni les invites privées des flux de travail.

Portée de la vérification

Le 2026-10-19, avec le plugin officiel 0.0.68, la conversation texte Haiku et l’appel en flux ont été réalisés dans Dify Cloud et correspondent aux journaux de la passerelle. Le DSL sans clé exporté a été importé dans le même espace de travail en tant que nouvelle application. Après l’import, un test ultérieur a rencontré un 503 dû à une limite amont ; cette passe n’est donc pas comptée comme réussie après import.

Il s’agit d’un test interne avec une plage de temps précise, pas d’une garantie de disponibilité continue. L’import dans un espace de travail neuf, les anciennes versions de Dify, les appels d’outils, la vision et la recherche dans la base de connaissances n’ont pas encore été vérifiés ; effectuez votre premier test avec votre propre clé dans les limites de votre quota.

Code source du plugin officiel · Marché de plugins Dify

English / Русский

English: Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to https://1zheai.com/v1, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support.

Русский: Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL https://1zheai.com/v1, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.