--- title: "Intégration de Dify" description: "Configurez 1折AI à l'aide du plugin officiel OpenAI-API-compatible de Dify : configuration du modèle, test de conversation et dépannage du premier appel." headingIds: {"Préparation":"section-1","Ajouter un modèle":"section-2","Commencer dès la première conversation":"section-3","Importer un Chatflow d’exemple":"section-4","Questions fréquentes":"section-5","Obtenir de l’aide pour l’intégration":"section-6","Portée de la vérification":"section-7","English / Русский":"section-8"} --- 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 la[console](https://1zheai.com/console?lng=fr). - 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é](/fr/docs/downloads/1zheai-dify-chatflow.yml), 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](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Marché de plugins Dify](https://marketplace.dify.ai/) ## 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. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.