डिफाई एपीआई
मुफ्त
Dify API
Dify API: प्रोग्राम योग्य इंटरफ़ेस के रूप में LLM एप्लिकेशन ऑर्केस्ट्रेशन क्षमताओं को खोलें
मुख्य पैरामीटर और आँकड़े
Dify API एक स्वतंत्र क्लाउड सेवा नहीं है, बल्कि Dify प्लेटफ़ॉर्म की API सेवा परत है - यह RESTful इंटरफ़ेस के माध्यम से Dify के विज़ुअल वर्कफ़्लो इंजन, RAG नॉलेज बेस एजेंट बिल्डर और बाहरी सिस्टम कॉल के लिए मॉडल गेटवे की क्षमताओं को उजागर करता है। उत्पाद स्वरूप के परिप्रेक्ष्य से, Dify API, Dify के लिए "आंतरिक ऑर्केस्ट्रेशन टूल्स" से "प्लेटफ़ॉर्म इन्फ्रास्ट्रक्चर" की ओर बढ़ने का प्रमुख पुल है।
| प्रोजेक्ट्स | सार्वजनिक सूचना |
|---|---|
| आधिकारिक स्थिति | Dify प्लेटफ़ॉर्म की RESTful API सेवा परत |
| इंटरफ़ेस प्रोटोकॉल | बाकी (HTTP/HTTPS) + JSON |
| प्रमाणीकरण विधि | एपीआई कुंजी (ऐप-स्तर) + टोकन (सत्र स्तर) |
| कोर समापन बिंदु कवरेज | वर्कफ़्लो निष्पादन, सत्र प्रबंधन, ज्ञान आधार पुनर्प्राप्ति, दस्तावेज़ अपलोड, एप्लिकेशन प्रबंधन |
| निष्पादन मोड | सिंक्रोनस (प्रतीक्षा को अवरुद्ध करना) / एसिंक्रोनस (कॉलबैक या पोलिंग) |
| एपीआई दस्तावेज़ीकरण | ओपनएपीआई 3.0 विशिष्टता (प्लेटफ़ॉर्म संस्करण के साथ अद्यतन) |
| एसडीके समर्थन | पायथन, जावास्क्रिप्ट/टाइपस्क्रिप्ट (समुदाय + आधिकारिक रखरखाव) |
| दर सीमा | पैकेज स्तर से विभाजित (मुफ़्त संस्करण 200 संदेश प्रति दिन, व्यावसायिक संस्करण असीमित) |
| परिनियोजन विधि | क्लाउड संस्करण स्वचालित रूप से सक्षम है / स्व-होस्ट किए गए संस्करण को एपीआई गेटवे को कॉन्फ़िगर करने की आवश्यकता है |
| प्लेटफ़ॉर्म संस्करण के साथ सिंक्रनाइज़ | Dify प्लेटफ़ॉर्म संस्करण संख्या (वर्तमान में v1.14.2) के अनुरूप |
पोजीशनिंग अंतर: Dify API और Dify वेब कंसोल के बीच संबंध स्ट्राइप एपीआई और स्ट्राइप डैशबोर्ड के समान है - पूर्व प्रोग्राम कॉल के लिए एक ऑर्केस्ट्रेशन परत है, और बाद वाला मानव ऑपरेशन के लिए एक ग्राफिकल इंटरफ़ेस है। दोनों एक ही वर्कफ़्लो इंजन और नॉलेज बेस पाइपलाइन साझा करते हैं, और एकमात्र अंतर इंटरैक्शन प्रवेश में है। डेवलपर्स द्वारा कंसोल के बजाय एपीआई चुनने का मुख्य कारण "स्वचालित एकीकरण" है: उपयोगकर्ताओं को संचालन के लिए Dify इंटरफ़ेस पर स्विच करने की अनुमति देने के बजाय मौजूदा बिजनेस सिस्टम में AI वर्कफ़्लो को एम्बेड करना।
उपयोग मोड में अंतर: Dify API सिंक्रोनस और एसिंक्रोनस निष्पादन मोड दोनों का समर्थन करता है। सिंक्रोनस मोड सरल प्रश्न और उत्तर परिदृश्यों के लिए उपयुक्त है (अनुरोध-प्रतिक्रिया 30 सेकंड के भीतर पूरा हो जाता है); एसिंक्रोनस मोड लंबे समय तक चलने वाले वर्कफ़्लो (जैसे मल्टी-स्टेप एजेंट कार्य, बड़े पैमाने पर आरएजी पुनर्प्राप्ति + पीढ़ी) के लिए उपयुक्त है, और अंतिम परिणाम वेबहुक कॉलबैक या पोलिंग के माध्यम से प्राप्त किए जाते हैं। यह डुअल-मोड डिज़ाइन दो विशिष्ट आवश्यकताओं को शामिल करता है: ऑनलाइन कम विलंबता और ऑफ़लाइन बैच प्रोसेसिंग।
उपयोगकर्ता और बाज़ार की पहचान
Dify API का उपयोगकर्ता समूह Dify प्लेटफ़ॉर्म के साथ अत्यधिक ओवरलैप करता है, लेकिन इसकी तकनीकी प्रोफ़ाइल एक मजबूत "डेवलपर-उन्मुख" सुविधा दिखाती है।
अपनाने का डेटा: Dify प्लेटफ़ॉर्म GitHub 143K+ स्टार्स और 22K+ फोर्क्स के सामुदायिक आधार के बीच, API उपयोगकर्ता सक्रिय डेवलपर्स के एक निश्चित अनुपात के लिए जिम्मेदार हैं - इसकी पुष्टि API एकीकरण मुद्दों से की जा सकती है जो अक्सर GitHub मुद्दों में दिखाई देते हैं, SDK वेयरहाउस में सितारों की संख्या, और npm/PyPI डाउनलोड की संख्या। पंजीकृत कार्यक्षेत्र के डिफी क्लाउड संस्करण में, वेब कंसोल के बजाय एपीआई के माध्यम से बनाए गए एप्लिकेशन का अनुपात 20-30% के बीच होने का अनुमान है (सामुदायिक चर्चाओं के अनुसार), और बढ़ रहा है।
विशिष्ट एकीकरण परिदृश्य: सार्वजनिक मामलों से पता चलता है कि एंटरप्राइज़ ग्राहकों के लिए Dify API का उपयोग करने के विशिष्ट पैटर्न में शामिल हैं: मौजूदा CRM/ERP सिस्टम में AI वर्कफ़्लो को एम्बेड करना, API के माध्यम से स्व-निर्मित ज्ञान आधार अनुप्रयोगों को जोड़ना, और कॉर्पोरेट WeChat/Feishu/DingTalk में AI Q&A रोबोट को एकीकृत करना। इन परिदृश्यों की सामान्य विशेषता "मूल सिस्टम को अपरिवर्तित छोड़ना और केवल एआई ऑर्केस्ट्रेशन परत जोड़ना" है - डिफाई एपीआई पुराने और नए सिस्टम के बीच गोंद परत के रूप में कार्य करता है।
प्रतिस्पर्धी एपीआई के साथ तुलना: "प्रोग्रामेबल एलएलएम ऑर्केस्ट्रेशन एपीआई" के खंड में, डिफाई एपीआई के प्रत्यक्ष बेंचमार्किंग उत्पादों में कोज़ एपीआई (बाइटडांस), फ्लोवाइज एपीआई और लैंगफ्लो एपीआई शामिल हैं। Dify API का मुख्य अंतर "प्लेटफ़ॉर्म पूर्णता" में निहित है - अन्य तीन को या तो बाहरी RAG क्षमताओं (फ्लोवाइज/लैंगफ्लो) की आवश्यकता होती है या स्वयं-होस्टेड (Coze) नहीं किया जा सकता है, जबकि Dify API एक ही समय में RAG अंतर्निर्मित, स्व-होस्टेड परिनियोजन और मॉडल गेटवे के तीन आयामों को संतुष्ट करता है।
| आयामों की तुलना करें | डिफाई एपीआई | कोज़ एपीआई | फ़्लोवाइज एपीआई | लैंगफ्लो एपीआई |
|---|---|---|---|---|
| आरएजी नॉलेज बेस एपीआई | ✅ अंतर्निहित, संपूर्ण खोज समापन बिंदु | ✅ बिल्ट-इन | ❌ बाहरी प्लग-इन की आवश्यकता है | ❌ बाहरी प्लग-इन की आवश्यकता है |
| वर्कफ़्लो निष्पादन एपीआई | ✅ सिंक्रोनस + एसिंक्रोनस | ✅ सिंक्रोनस | ✅ सिंक्रोनस | ✅ सिंक्रोनस |
| मॉडल गेटवे एपीआई | ✅ एकीकृत प्रबंधन + रूटिंग | ❌ कोई नहीं | ❌ कोई नहीं | ❌ कोई नहीं |
| स्व-होस्टेड परिनियोजन | ✅ सामुदायिक संस्करण निःशुल्क बनाया जा सकता है | ❌ केवल बादल | ✅ डॉकर | ✅ डॉकर |
| एपीआई दस्तावेज़ीकरण विशिष्टता | ओपनएपीआई 3.0 | कस्टम | कस्टम | कस्टम |
| दर सीमा पारदर्शिता | पैकेज प्रणाली, व्यावसायिक संस्करण के लिए कोई ऊपरी सीमा नहीं | एक मासिक सीमा है | कोई आधिकारिक सीमा नहीं | कोई आधिकारिक सीमा नहीं |
बाजार पहचान निष्कर्ष: Dify API "सेल्फ-होस्टिंग + बिल्ट-इन RAG + पूर्ण वर्कफ़्लो ऑर्केस्ट्रेशन की आवश्यकता है" के चौराहे पर अच्छी तरह से स्थित है। Dify वेब कंसोल का उपयोग करके पहले से ही ऐप बनाने वाली टीमों के लिए, एपीआई कार्यक्षमता का एक प्राकृतिक विस्तार है - कम सीखने की अवस्था और प्रौद्योगिकी स्टैक को स्विच करने की कोई आवश्यकता नहीं है।
लागत लाभ
Dify API के लागत विश्लेषण को Dify प्लेटफ़ॉर्म के समग्र मूल्य निर्धारण से जोड़ा जाना चाहिए: API पर अलग से शुल्क नहीं लिया जाता है, और इसकी कॉल कोटा और दर सीमा Dify पैकेज द्वारा निर्धारित की जाती है। इसका मतलब है कि एपीआई की सीमांत लागत शून्य के करीब है - चूंकि आप पहले ही प्लेटफ़ॉर्म के लिए भुगतान कर चुके हैं, एपीआई कॉल एक सम्मिलित मूल्य-वर्धित क्षमता है।
सी-साइड और व्यक्तिगत डेवलपर्स:
- स्पष्ट लागत: क्लाउड मुक्त संस्करण में दैनिक संदेश कोटा 200 है, और एपीआई कॉल को उसी संदेश कोटा में गिना जाता है। सीमा पार होने के बाद पैकेज को अपग्रेड करना होगा। सामुदायिक संस्करण की स्व-होस्टिंग पूरी तरह से मुफ़्त है और केवल सर्वर लागत (न्यूनतम 2-कोर 4 जीबी इंस्टेंस, मासिक शुल्क लगभग 50-200 येन) है।
- छिपी हुई लागत: स्वयं-होस्टेड होने पर एपीआई गेटवे का परिनियोजन कॉन्फ़िगरेशन (Nginx रिवर्स प्रॉक्सी HTTPS प्रमाणपत्र एपीआई कुंजी प्रबंधन); क्लाउड संस्करण की एपीआई प्रतिक्रिया देरी नेटवर्क स्थितियों से प्रभावित होती है, और सीमा पार पहुंच के लिए अतिरिक्त त्वरण समाधान की आवश्यकता हो सकती है।
- अनुशंसित पथ: प्रोटोटाइप सत्यापन अवधि के दौरान क्लाउड मुक्त संस्करण का उपयोग करें; संवेदनशील बजट और कुछ संचालन और रखरखाव क्षमताओं वाले व्यक्तिगत डेवलपर्स स्वयं-होस्टिंग के लिए सामुदायिक संस्करण चुनते हैं।
एपीआई डेवलपर्स और छोटी टीमें:
- स्पष्ट लागत: डिफाई क्लाउड प्रो $59/माह/कार्यक्षेत्र, कोई एपीआई कॉल सीमा नहीं। मॉडल एपीआई शुल्क अतिरिक्त है (डेवलपर सीधे मॉडल आपूर्तिकर्ता को भुगतान करता है, और Dify कोई कमीशन नहीं लेता है)। सालाना भुगतान करें और लगभग 15-20% छूट प्राप्त करें।
- छिपी हुई लागत: मुफ़्त संस्करण से पेशेवर संस्करण में अपग्रेड करते समय, आपको एपीआई कुंजी और अनुमतियों को फिर से कॉन्फ़िगर करना होगा; सामुदायिक संस्करण से क्लाउड संस्करण में एपीआई माइग्रेशन में डेटा निर्यात शामिल है।
- अनुशंसित पथ: जब 3-10 लोगों की टीम के पास पूर्णकालिक संचालन और रखरखाव नहीं होता है, तो $59/माह पर क्लाउड प्रोफेशनल संस्करण की लागत स्व-होस्ट किए गए बुनियादी ढांचे + संचालन और रखरखाव जनशक्ति निवेश की तुलना में कम है।
उद्यम निजीकरण परिनियोजन:
- स्पष्ट लागत: एंटरप्राइज़ संस्करण की कीमत को व्यावसायिक पुष्टि की आवश्यकता है (उद्योग अभ्यास के आधार पर $2,000-20,000/वर्ष होने का अनुमान है)। एपीआई सेवा स्वयं एंटरप्राइज़ संस्करण परिनियोजन पैकेज में शामिल है।
- छिपी हुई लागत: निजीकृत तैनाती के तहत एपीआई संचालन और रखरखाव लागत (एपीआई गेटवे उच्च-उपलब्धता कॉन्फ़िगरेशन, निगरानी अलार्म, लॉग संग्रह, अपग्रेड संगतता परीक्षण); एंटरप्राइज़ आंतरिक एपीआई का सुरक्षा प्रशासन (एपीआई कुंजी रोटेशन, एक्सेस ऑडिट)।
- अनुशंसित पथ: वित्त, चिकित्सा और सरकारी मामलों जैसे विनियमित उद्योग एंटरप्राइज़ संस्करण के मूल्यांकन को प्राथमिकता देते हैं - इसका अनुपालन मूल्य (डेटा संप्रभुता + ऑडिट लॉग) शुद्ध एपीआई फ़ंक्शन से अधिक है।
त्रिस्तरीय लागत तुलना:
| लागत आयाम | सामुदायिक एपीआई (स्वयं-होस्टेड) | क्लाउड प्रोफेशनल एपीआई | एंटरप्राइज एपीआई |
|---|---|---|---|
| एपीआई लाइसेंस शुल्क | $0 | $59/माह योजना में शामिल | एंटरप्राइज़ अनुबंध में शामिल |
| बुनियादी ढांचे की लागत | $10-30/माह (सर्वर) | सदस्यता में शामिल | जेब से बाहर या अनुबंध में शामिल |
| मॉडल एपीआई शुल्क | अतिरिक्त | अतिरिक्त | बंडल किया जा सकता है और बातचीत की जा सकती है |
| एपीआई संचालन और रखरखाव जनशक्ति | टीम को तैयार रहने की जरूरत है | कोई जरुरत नहीं | परिनियोजन मोड पर निर्भर करता है |
| दर सीमा | कोई नहीं (स्वचालित) | असीमित | कस्टम |
| डेटा संप्रभुता | पूर्णतः स्वायत्त | Dify क्लाउड पर होस्ट किया गया | निजी क्लाउड/ऑन-प्रिमाइस |
मुख्य कार्य
Dify API के मुख्य कार्य "Dify प्लेटफ़ॉर्म क्षमताओं को प्रोग्रामयोग्य इंटरफ़ेस के रूप में खोलने" के लक्ष्य के इर्द-गिर्द घूमते हैं। वेब कंसोल के बटनों को केवल REST एंडपॉइंट पर मैप करने के बजाय, प्रत्येक क्षमता के लिए एपीआई शब्दार्थ एकीकरण परिदृश्यों के लिए डिज़ाइन किए गए हैं।
-
वर्कफ़्लो निष्पादन एपीआई:
POST /workflows/runऔरPOST /workflows/run-asyncसमापन बिंदुओं के माध्यम से AI वर्कफ़्लो निष्पादन को ट्रिगर करता है, प्रारंभिक चर और संदर्भ में पासिंग का समर्थन करता है। सिनर्जीज़: वर्कफ़्लो एपीआई Dify के विज़ुअल ऑर्केस्ट्रेशन इंजन के साथ समान निष्पादन रनटाइम साझा करता है - वेब कंसोल पर डीबग किए गए वर्कफ़्लो एपीआई के माध्यम से कॉल किए जाने पर बिल्कुल वैसा ही व्यवहार करते हैं, जिससे एपीआई एकीकरण परिदृश्यों के लिए अलग ऑर्केस्ट्रेशन की आवश्यकता समाप्त हो जाती है। "एक बार व्यवस्थित करें, कई स्थानों पर कॉल करें" मॉडल पारंपरिक एकीकरण में "परीक्षण का संदर्भ है और उत्पादन का संदर्भ है" की पृथक्करण समस्या से बचा जाता है। -
सत्र प्रबंधन एपीआई: मल्टी-राउंड वार्तालाप संदर्भों के स्वचालित रखरखाव का समर्थन करते हुए,
POST /chat-messagesसमापन बिंदु के माध्यम से वार्तालाप सत्र बनाएं और प्रबंधित करें। सिनर्जी: सत्र प्रबंधन एपीआई और वर्कफ़्लो एपीआई का उपयोग श्रृंखला में किया जा सकता है - एक जटिल बहु-चरणीय कार्य को एक स्टेटफुल एआई इंटरेक्शन प्रक्रिया को प्राप्त करने के लिए "सत्र दृढ़ता संदर्भ -> वर्कफ़्लो निष्पादन -> परिणाम को सत्र में वापस लिखना" के चक्र में विघटित किया जा सकता है। -
नॉलेज बेस रिट्रीवल एपीआई:
POST /datasets/:id/retrieveएंडपॉइंट के माध्यम से निर्दिष्ट नॉलेज बेस से प्रासंगिक दस्तावेज़ टुकड़े पुनर्प्राप्त करें, जो वेक्टर पुनर्प्राप्ति, पूर्ण-पाठ पुनर्प्राप्ति और हाइब्रिड पुनर्प्राप्ति के तीन तरीकों का समर्थन करता है। सिनर्जी: पुनर्प्राप्ति एपीआई का उपयोग एलएलएम कॉल से स्वतंत्र रूप से किया जा सकता है - बाहरी सिस्टम पहले ज्ञान खंड प्राप्त करने के लिए पुनर्प्राप्ति एपीआई को कॉल करता है, और फिर स्वयं निर्णय लेता है कि टुकड़े को एलएलएम में पास करना है या नहीं। यह "पुनर्प्राप्ति-पीढ़ी पृथक्करण" मोड उन परिदृश्यों में बहुत व्यावहारिक है, जिनमें शीघ्र निर्माण पर अच्छे नियंत्रण की आवश्यकता होती है। -
दस्तावेज़ प्रबंधन एपीआई: दस्तावेज़ अपलोड (
POST /datasets/:id/document), विलोपन, अद्यतन और स्थिति क्वेरी एंडपॉइंट प्रदान करता है। सिनर्जी: दस्तावेज़ प्रबंधन एपीआई और पुनर्प्राप्ति एपीआई ज्ञान आधार के "हॉट अपडेट" को साकार करने के लिए सहयोग करते हैं - बाहरी प्रणाली क्रमिक रूप से एपीआई के माध्यम से नए दस्तावेज़ अपलोड करती है, और ज्ञान आधार सूचकांक को मैन्युअल रूप से ताज़ा करने की आवश्यकता के बिना, पुनर्प्राप्ति अंत तुरंत प्रभावी होता है। -
एप्लिकेशन प्रबंधन और कॉन्फ़िगरेशन एपीआई: एंडपॉइंट की
GET/POST /appsश्रृंखला के माध्यम से Dify एप्लिकेशन के जीवन चक्र को प्रबंधित करें (बनाएं, क्वेरी करें, अपडेट करें, हटाएं), जिसमें एप्लिकेशन पैरामीटर प्राप्त करना, एप्लिकेशन सेटिंग्स अपडेट करना और एपीआई कुंजी प्रबंधित करना शामिल है। सिनर्जी: एप्लिकेशन प्रबंधन एपीआई DevOps टीम को CI/CD पाइपलाइन में Dify अनुप्रयोगों के निर्माण और कॉन्फ़िगरेशन को शामिल करने की अनुमति देता है - स्वचालित रूप से एप्लिकेशन बनाता है, मॉडल कॉन्फ़िगर करता है, और नई सीमा तैनाती के दौरान एपीआई कुंजी सेट करता है, जिससे मैन्युअल कॉन्फ़िगरेशन में चूक का जोखिम कम हो जाता है। -
टेक्स्ट जेनरेशन एपीआई: टेक्स्ट जेनरेशन कार्य को पूरा करने के लिए
POST /completion-messagesएंडपॉइंट के माध्यम से Dify वर्कफ़्लो में सीधे LLM नोड को कॉल करें। यह अनुवाद, सारांश, कॉपी राइटिंग जेनरेशन और अन्य परिदृश्यों के लिए उपयुक्त है, जिनमें संवाद के कई दौर के रखरखाव की आवश्यकता नहीं होती है। -
फ़ाइल अपलोड एपीआई:
POST /files/uploadके माध्यम से छवियों और दस्तावेज़ों जैसी फ़ाइलों को अपलोड करने का समर्थन करता है, और अपलोड की गई फ़ाइलों को वर्कफ़्लो निष्पादन या वार्तालाप संदेशों में संदर्भित करता है। अपलोड की गई फ़ाइलें स्वचालित रूप से संबंधित ज्ञान आधारों में वर्गीकृत की जाती हैं या वर्कफ़्लो नोड्स के रूप में दर्ज की जाती हैं।
सिनर्जी अवलोकन: डिफाई एपीआई का मूल्य व्यक्तिगत समापन बिंदुओं की कार्यक्षमता में नहीं, बल्कि उन्हें संयोजित करने की क्षमता में निहित है। उदाहरण के लिए, एक विशिष्ट "स्मार्ट ग्राहक सेवा" एकीकरण लिंक: दस्तावेज़ प्रबंधन एपीआई (अपलोड उत्पाद मैनुअल) → ज्ञान आधार पुनर्प्राप्ति एपीआई (बिल्ड इंडेक्स) → वर्कफ़्लो निष्पादन एपीआई (पुनर्प्राप्ति + एलएलएम पीढ़ी + एजेंट टूल कॉल) → सत्र प्रबंधन एपीआई (बातचीत संदर्भ के कई दौर बनाए रखें)। चार समापन बिंदुओं का संयोजन एक एंड-टू-एंड बुद्धिमान प्रश्न और उत्तर प्रणाली को पूरा करता है, और प्रत्येक समापन बिंदु स्वतंत्र रूप से अन्य परिदृश्यों की सेवा कर सकता है।
मॉडल और संस्करण विकास
Dify API का संस्करण Dify प्लेटफ़ॉर्म संस्करण से जुड़ा हुआ है, और API की पुनरावृत्ति लय प्लेटफ़ॉर्म के मेनलाइन संस्करण का अनुसरण करती है। v1.0 के आधिकारिक संस्करण से वर्तमान v1.14.x तक, एपीआई परत ने "मूल रूप से उपलब्ध" से "पूर्ण कवरेज" तक विकास का अनुभव किया है।
एपीआई संस्करण संदर्भ
-
v1.0 (2025-01-01): माइलस्टोन संस्करण। Dify प्लेटफ़ॉर्म v1.0 के साथ समन्वय में, एपीआई परत आधिकारिक तौर पर उत्पादन-तैयार चरण में प्रवेश कर गई है। पूर्ण तीन मुख्य समापन बिंदु प्रदान करता है: वर्कफ़्लो निष्पादन, सत्र प्रबंधन, और ज्ञान आधार पुनर्प्राप्ति। OpenAPI 3.0 विनिर्देश दस्तावेज़ और Python/JS SDK का पहला संस्करण जारी किया।
-
v1.5 (2025-06): निष्पादन परिणामों की वेबहुक कॉलबैक अधिसूचना का समर्थन करने के लिए एसिंक्रोनस वर्कफ़्लो निष्पादन एंडपॉइंट (
/वर्कफ़्लो/रन-एसिंक) जोड़ा गया। नॉलेज बेस सर्च एपीआई हाइब्रिड खोज पैरामीटर (search_methodफ़ील्ड) जोड़ता है। फ़ाइल अपलोड एपीआई ऑनलाइन है. -
v1.10 (2025-12): एप्लिकेशन प्रबंधन एपीआई श्रृंखला के समापन बिंदु ऑनलाइन हैं, एपीआई के माध्यम से डिफाई अनुप्रयोगों के निर्माण और प्रबंधन का समर्थन करते हैं। टेक्स्ट जेनरेशन एपीआई (
/completion-messages) स्वतंत्र रूप से जारी किया जाता है और सत्र संदर्भ पर भरोसा किए बिना एकल टेक्स्ट जेनरेशन कार्य को पूरा कर सकता है। -
v1.14.0 (2026-04-29): एजेंट ऑर्केस्ट्रेशन से संबंधित समापन बिंदुओं को प्लेटफ़ॉर्म एजेंट आर्किटेक्चर के उन्नयन के साथ अद्यतन किया जाता है; एपीआई एजेंट नोड्स में टूल कॉल परिणाम रिटर्न प्रारूप में सुधार जोड़ता है। दर सीमा रणनीति को अनुकूलित किया गया है, और व्यावसायिक संस्करण और उससे ऊपर के संस्करण के लिए एपीआई कॉल की ऊपरी सीमा रद्द कर दी गई है।
-
v1.14.1 (2026-05-12): सुरक्षा सख्त करना - एपीआई कुंजी रोटेशन तंत्र में सुधार, अनुरोध हस्ताक्षर सत्यापन संवर्द्धन। वर्कफ़्लो एपीआई स्थिरता में सुधार - टाइमआउट हैंडलिंग अधिक पूर्वानुमानित है और त्रुटि प्रतिक्रिया प्रारूप मानकीकृत हैं।
-
v1.14.2 (2026-05-19): निरंतर सुरक्षा संवर्द्धन और बग समाधान। एजेंट की अंतर्निहित वास्तुकला में सुधार किया गया है (बाद में उन्नत एजेंट क्षमताओं के लिए मार्ग प्रशस्त करने के लिए), और एपीआई स्तर एजेंट नोड आउटपुट के संरचनात्मक अनुकूलन में परिलक्षित होता है।
संस्करण सुविधाओं का सारांश
- प्लेटफ़ॉर्म संस्करण संख्या के साथ लॉक किया गया: एपीआई संस्करण स्वतंत्र रूप से क्रमांकित नहीं है और Dify प्लेटफ़ॉर्म संस्करण के अनुरूप है। यह संस्करण प्रबंधन की जटिलता को कम करता है, लेकिन इसका मतलब है कि एपीआई स्तर पर परिवर्तनों में शुद्ध एपीआई परिवर्तनों के बजाय प्लेटफ़ॉर्म सुविधा अपडेट शामिल हो सकते हैं।
- आरएजी क्षमताएं पहले परिपक्व होती हैं: ज्ञान आधार पुनर्प्राप्ति एपीआई में सभी समापन बिंदुओं के बीच सबसे तेज़ पुनरावृत्ति होती है, जो "ज्ञान प्रबंधन" परिदृश्यों पर डिफी के रणनीतिक जोर को दर्शाती है।
- एसिंक्रोनस क्षमताएं धीरे-धीरे पूरी हो रही हैं: v1.0 के सिंक्रोनस निष्पादन से लेकर v1.5 के एसिंक्रोनस समर्थन तक, और फिर बाद के वेबहुक और पोलिंग तंत्र तक, एपीआई का निष्पादन मोड धीरे-धीरे परिपक्व हो गया है।
- सुरक्षा और शासन को संस्करण दर संस्करण बढ़ाया जाता है: v1.14.x श्रृंखला में कई बार सुरक्षा सख्त करने का उल्लेख किया गया है, जो दर्शाता है कि एपीआई परत "उपलब्ध कार्यक्षमता" से "उद्यम-स्तरीय सुरक्षा" में परिवर्तित हो रही है।
तकनीकी लाभ
Dify API का तकनीकी लाभ एकल एल्गोरिथ्म के नेतृत्व में नहीं है, बल्कि "वास्तुशिल्प एकता" और "इंजीनियरिंग गहराई" में निहित है - यह जटिल वर्कफ़्लो इंजन RAG पाइपलाइन एजेंट रनटाइम और Dify प्लेटफ़ॉर्म के मॉडल गेटवे को शब्दार्थ रूप से सुसंगत REST API के एक सेट में एकीकृत करता है।
एकीकृत निष्पादन रनटाइम
जब Dify API को कॉल किया जाता है, तो अनुरोध Dify के वर्कफ़्लो इंजन में प्रवेश करता है, जो डायरेक्टेड ग्राफ़ (DAG) पर आधारित एक निष्पादन ढांचा है। एपीआई अनुरोध के मापदंडों को वर्कफ़्लो इनपुट चर में मैप किया जाता है, और इंजन उन्हें पूर्वनिर्धारित नोड टोपोलॉजी में क्रमिक रूप से निष्पादित करता है, अंततः आउटपुट को JSON प्रतिक्रिया में क्रमबद्ध करता है। इस डिज़ाइन का मुख्य मूल्य है: वेब कंसोल और एपीआई निष्पादन पथ पूरी तरह से सुसंगत हैं - समान वर्कफ़्लो कैनवास पर परीक्षण पास करने के बाद, एपीआई कॉल के माध्यम से व्यवहार सैद्धांतिक रूप से 100% पुन: प्रस्तुत किया जाना चाहिए।
तंत्र -> प्रभाव -> परिदृश्य: रनटाइम का एकीकृत निष्पादन "परीक्षण संदर्भ और उत्पादन संदर्भ के बीच असंगत प्रदर्शन" के जोखिम को समाप्त करता है। Dify API को ग्राहक-सामना वाले सिस्टम (जैसे ग्राहक सेवा बॉट, रिपोर्ट जेनरेटर) में एकीकृत करने वाली टीमों के लिए, इसका मतलब है कि वर्कफ़्लो ऑर्केस्ट्रेटर (शायद गैर-तकनीकी भूमिकाओं में) और एपीआई एकीकरण इंजीनियर समानांतर में काम कर सकते हैं, प्रत्येक अपने स्वयं के टूलचेन में परिणामों को मान्य कर सकता है, अंततः उत्पादन वातावरण में निर्बाध रूप से एकीकृत हो सकता है।
REST API का स्तरित डिज़ाइन
Dify API को वास्तुशिल्प रूप से तीन तार्किक परतों में विभाजित किया गया है:
- एक्सेस लेयर (एपीआई गेटवे): अनुरोध प्रमाणीकरण (एपीआई कुंजी सत्यापन), दर सीमा, अनुरोध लॉग और क्रॉस-डोमेन कॉन्फ़िगरेशन को संभालता है। स्व-होस्टेड परिनियोजन में, यह परत आमतौर पर Nginx या Kubernetes Ingress द्वारा कार्यान्वित की जाती है।
- ऑर्केस्ट्रेशन लेयर (वर्कफ़्लो इंजन): एपीआई अनुरोध पैरामीटर को पार्स करता है, वर्कफ़्लो निष्पादन संदर्भ को तुरंत चालू करता है, और डीएजी नोड्स के निष्पादन अनुक्रम को शेड्यूल करता है। यह परत Dify API का मूल है - यह RESTful अनुरोध सेमेन्टिक्स को वर्कफ़्लो निष्पादन सेमेन्टिक्स में परिवर्तित करता है।
- संसाधन परत (सेवा एडाप्टर): मॉडल आपूर्तिकर्ता एपीआई, वेक्टर डेटाबेस और फ़ाइल भंडारण जैसे बाहरी संसाधनों से कनेक्ट करें। एपीआई कॉल करने वालों को सीधे तौर पर इन बैकएंड संसाधनों के अस्तित्व का एहसास नहीं होता है, और सभी अनुकूलन तर्क ऑर्केस्ट्रेशन परत के नीचे समाहित होते हैं।
तंत्र -> प्रभाव -> परिदृश्य: स्तरित डिज़ाइन एपीआई कॉलर्स को केवल "कौन से पैरामीटर पास किए गए हैं और क्या परिणाम प्राप्त हुए हैं" पर ध्यान केंद्रित करने की अनुमति देता है, बिना इस बात की परवाह किए कि कौन सा मॉडल बैकएंड से जुड़ा है या कौन सा वेक्टर डेटाबेस उपयोग किया जाता है। जब बैकएंड संसाधनों को स्विच किया जाता है (जैसे ओपनएआई से डीपसीक तक), तो एपीआई एंडपॉइंट और प्रतिक्रिया प्रारूप पूरी तरह से अपरिवर्तित रहते हैं, कॉलर में शून्य परिवर्तन होते हैं।
हाइब्रिड आरएजी पुनर्प्राप्ति एपीआई का तकनीकी कार्यान्वयन
Dify API के नॉलेज बेस सर्च एंडपॉइंट के पीछे Dify का हाइब्रिड सर्च इंजन है, जो तीन खोज रणनीतियों का समर्थन करता है:
- वेक्टर पुनर्प्राप्ति (सघन): सिमेंटिक वेक्टर स्पेस में क्वेरीज़ और दस्तावेज़ अंशों को मैप करने और कोसाइन समानता की गणना करने के लिए एंबेडिंग मॉडल का उपयोग करें। यह शब्दार्थ मिलान परिदृश्यों के लिए उपयुक्त है, लेकिन व्यावसायिक शब्दों के सटीक मिलान के प्रति संवेदनशील नहीं है।
- पूर्ण पाठ खोज (स्पार्स/बीएम25): कीवर्ड मिलान पर आधारित पारंपरिक सूचना पुनर्प्राप्ति विधि। सटीक हिट परिदृश्यों के लिए उपयुक्त, लेकिन अर्थ संबंधी विविधताओं के प्रति असंवेदनशील।
- हाइब्रिड पुनर्प्राप्ति (हाइब्रिड): कॉन्फ़िगर करने योग्य वजन के अनुसार घने और विरल के खोज परिणामों को फ्यूज करें, और फिर रीरैंक मॉडल के माध्यम से फ्यूजन परिणामों को परिष्कृत करें।
तंत्र -> प्रभाव -> परिदृश्य: हाइब्रिड खोज को 'search_method' पैरामीटर के माध्यम से एपीआई स्तर पर कॉलर के सामने उजागर किया जाता है। कानूनी अनुबंध पुनर्प्राप्ति जैसे परिदृश्यों के लिए जहां "सिमेंटिक समझ + सटीक कीवर्ड हिट" दोनों महत्वपूर्ण हैं, हाइब्रिड मोड चुनना + सेटिंग dense_weight=0.6, sparse_weight=0.4 आमतौर पर एकल खोज मोड की तुलना में पहली हिट दर में 15-25% सुधार करता है। रीरैंक चरण में लगभग 100-300ms की अतिरिक्त देरी होती है। वास्तविक समय के प्रश्न और उत्तर परिदृश्यों में जो देरी के प्रति संवेदनशील होते हैं, इसे आवश्यकताओं के आधार पर सक्षम या अक्षम किया जा सकता है।
Dify API टूल खुली सूची
Dify API कॉलर को कोर एंडपॉइंट्स (यानी, "टूल सेट") को उजागर करता है, प्रत्येक एंडपॉइंट एक पूर्ण एपीआई इंटरैक्शन के अनुरूप होता है:
| समापन बिंदु पथ | HTTP विधि | आचरण वर्णन | संगत परिदृश्य |
|---|---|---|---|
/चैट-संदेश |
पोस्ट | वर्कफ़्लो या एजेंट प्रतिक्रिया को ट्रिगर करने के लिए वार्तालाप संदेश भेजें | बुद्धिमान प्रश्नोत्तर, ग्राहक सेवा रोबोट |
/वर्कफ़्लो/रन |
पोस्ट | वर्कफ़्लो के समकालिक निष्पादन को ट्रिगर करें, ब्लॉक करें और वापसी की प्रतीक्षा करें | नियतात्मक कार्य (लेख निर्माण, रिपोर्ट) |
/workflows/run-async |
पोस्ट | वर्कफ़्लो के अतुल्यकालिक निष्पादन को ट्रिगर करें, Task_id लौटाएँ | दीर्घकालिक कार्य (बैच प्रसंस्करण, गहन विश्लेषण) |
/workflows/tasks/:id |
प्राप्त करें | क्वेरी अतुल्यकालिक कार्य निष्पादन स्थिति और परिणाम | अतुल्यकालिक कार्य प्रगति ट्रैकिंग |
/datasets/:id/retrieve |
पोस्ट | ज्ञानकोष से प्रासंगिक दस्तावेज़ अंश पुनर्प्राप्त करें | आरएजी प्रश्नोत्तरी, ज्ञान पुनर्प्राप्ति |
/डेटासेट/:आईडी/दस्तावेज़ |
पोस्ट | नॉलेज बेस पर दस्तावेज़ अपलोड करें | ज्ञानकोष का बैच निर्माण |
/डेटासेट/:आईडी/दस्तावेज़/:doc_id |
हटाएं | नॉलेज बेस से कोई दस्तावेज़ हटाएँ | ज्ञान आधार अद्यतन और रखरखाव |
/पूर्णता-संदेश |
पोस्ट | एकल पाठ पीढ़ी, कोई सत्र रखरखाव नहीं | अनुवाद, सारांश, कॉपी राइटिंग जनरेशन |
/फ़ाइलें/अपलोड |
पोस्ट | बाद के संदर्भ के लिए फ़ाइलें (चित्र, दस्तावेज़) अपलोड करें | मल्टी-मोडल इनपुट, दस्तावेज़ प्रसंस्करण |
/ऐप्स |
प्राप्त/पोस्ट करें | आवेदन सूची क्वेरी / नया आवेदन निर्माण | अनुप्रयोग जीवन चक्र प्रबंधन |
/apps/:id/api-keys |
प्राप्त/पोस्ट करें | एपीआई कुंजी प्रबंधन | सुरक्षा प्रशासन और कुंजी रोटेशन |
इंटरेक्शन विवरण: एक विशिष्ट "दस्तावेज़ प्रश्न और उत्तर" एकीकरण प्रक्रिया एपीआई एंडपॉइंट्स की श्रृंखला कॉल के माध्यम से पूरी की जाती है - POST /files/upload (अपलोड उत्पाद मैनुअल) → POST /datasets/:id/document (ज्ञान आधार में शामिल) → POST /chat-messages (उपयोगकर्ता प्रश्न, वर्कफ़्लो आंतरिक कॉल /datasets/:id/retrieve पुनर्प्राप्ति + उत्तर उत्पन्न करने के लिए एलएलएम) → अंतिम उत्तर लौटाएं। पूरी प्रक्रिया बाहरी सिस्टम के यूआई में उपयोगकर्ता द्वारा Dify कंसोल को छुए बिना पूरी की जाती है।
इंजीनियरिंग ख़तरा गाइड
डिफाई एपीआई की वास्तुशिल्प विशेषताओं और सामुदायिक प्रतिक्रिया के आधार पर, उत्पादन एकीकरण में निम्नलिखित विशिष्ट मुद्दे और प्रतिक्रिया रणनीतियाँ हैं:
-
एपीआई टाइमआउट और वर्कफ़्लो निष्पादन समय नियंत्रण से बाहर: एक जटिल वर्कफ़्लो का एकल निष्पादन (एकाधिक एलएलएम नोड श्रृंखला कॉल + ज्ञान आधार पुनर्प्राप्ति + एजेंट टूल कॉल) 60 सेकंड से अधिक हो सकता है, जिससे टाइमआउट ट्रिगर हो सकता है और एपीआई गेटवे का वियोग हो सकता है। समाधान: समय समाप्त होने वाले परिदृश्यों के लिए समान रूप से एसिंक्रोनस मोड (
/वर्कफ़्लो/रन-एसिंक) का उपयोग करें, और एक उचित वेबहुक कॉलबैक यूआरएल सेट करें; सिंक्रोनस मोड का उपयोग केवल पूर्वानुमानित प्रतिक्रिया समय के साथ सरल वर्कफ़्लो के लिए किया जाता है (निष्पादन समय <30 सेकंड की सीमा निर्धारित करने की अनुशंसा की जाती है)। वर्कफ़्लो डिज़ाइन स्तर पर, एकल नोड को बहुत अधिक टोकन का उपभोग करने और निष्पादन समय को लम्बा खींचने से रोकने के लिए कुंजी एलएलएम नोड्स परmax_tokensकी ऊपरी सीमा निर्धारित की जा सकती है। -
एपीआई कुंजी रिसाव और अनुमति क्रॉस-बॉर्डर: क्लाइंट एप्लिकेशन (जैसे वेब फ्रंट-एंड और मोबाइल ऐप्स) में डायरेक्ट एपीआई कुंजी को सीधे एम्बेड करने से कुंजी रिसाव का जोखिम शामिल होता है। हमलावर लीक हुई कुंजी का उपयोग मुफ्त कोटा समाप्त करने या उच्च लागत वाले मॉडल कॉल को ट्रिगर करने के लिए कर सकते हैं। समाधान: Dify API कुंजी को बैकएंड सेवा में रखा जाना चाहिए; क्लाइंट अनुरोध पहले स्व-निर्मित बैकएंड तक पहुंचता है, और फिर बैकएंड Dify API को कॉल करने के लिए एपीआई कुंजी ले जाता है। लिखने या हटाने के संचालन (दस्तावेज़ हटाना, एप्लिकेशन कॉन्फ़िगरेशन संशोधन) से जुड़े अंतिम बिंदुओं के लिए, व्यावसायिक स्तर पर द्वितीयक पुष्टिकरण या ऑपरेशन ऑडिट लॉग सेट करें। डिफाई क्लाउड प्रोफेशनल एडिशन और इसके बाद के संस्करण आईपी व्हाइटलिस्ट और एपीआई कुंजी स्कोप प्रतिबंधों का समर्थन करते हैं।
-
असंगत ज्ञान आधार पुनर्प्राप्ति परिणाम: एक ही क्वेरी अलग-अलग समय पर अलग-अलग बिंदुओं पर एक ही ज्ञान आधार पर
/datasets/:id/retrieveको कॉल करके अलग-अलग परिणाम देती है, जो दस्तावेज़ अपडेट में अनसिंक्रनाइज़्ड इंडेक्स, वेक्टर डेटाबेस स्थिरता में देरी, या एम्बेडिंग मॉडल संस्करण स्विचिंग के कारण हो सकता है। समाधान: दस्तावेज़ अद्यतन होने के बाद, पुनर्प्राप्ति करने से पहले सूचकांक स्थिति (indexing_statusफ़ील्डपूर्ण``) की पुष्टि करने के लिए दस्तावेज़ स्थिति क्वेरी एंडपॉइंट पर कॉल करें; संगति-संवेदनशील परिदृश्यों के लिए ज्ञान आधार के सिंक्रोनस इंडेक्सिंग मोड को सक्षम करें (इंडेक्स के पूरा होने की प्रतीक्षा में अपडेट ऑपरेशन अवरुद्ध हो जाते हैं); विसंगतियों का निवारण करते समय बैकट्रैकिंग के लिए पुनर्प्राप्ति एपीआई द्वारा लौटाए गए परिणाम काsession_id` रिकॉर्ड करें।
3 मिनट में जल्दी से आरंभ करें
Dify API के साथ आरंभ करने का सबसे तेज़ तरीका (उदाहरण के रूप में क्लाउड संस्करण लेते हुए):
- https://cloud.dify.ai पर लॉग इन करें, एक एप्लिकेशन बनाएं और एक एपीआई कुंजी प्राप्त करें (एप्लिकेशन सेटिंग्स → एपीआई कुंजी → कुंजी बनाएं)।
- पहला वार्तालाप संदेश भेजने के लिए कर्ल का उपयोग करें:
कर्ल -एक्स पोस्ट "https://api.dify.ai/v1/chat-messages" \
-एच "प्राधिकरण: वाहक <आपका_एपीआई_कुंजी>" \
-एच "सामग्री-प्रकार: एप्लिकेशन/जेसन" \
-डी '{
"इनपुट": {},
"क्वेरी": "हैलो, कृपया अपना परिचय दें",
"प्रतिक्रिया_मोड": "अवरुद्ध करना",
"उपयोगकर्ता": "डेमो-उपयोगकर्ता"
}'
- लौटाए गए परिणाम में
उत्तरफ़ील्ड जांचें, जो एआई की उत्तर सामग्री है।
स्व-होस्टेड परिनियोजन के लिए एपीआई एंडपॉइंट पता http://<your-domain>/v1 है, और अन्य पैरामीटर अपरिवर्तित रहते हैं। विस्तृत एपीआई दस्तावेज़ और एसडीके उपयोग के लिए, कृपया Dify आधिकारिक दस्तावेज़ और GitHub README देखें।
कैसे उपयोग करें
Dify API का प्रवेश परिनियोजन विधि के आधार पर भिन्न होता है, लेकिन प्रमाणीकरण विधि और कोर कॉलिंग मोड समान रहता है।
प्रवेश मैट्रिक्स:
| उपयोग | एपीआई समापन बिंदु आधार पता | लागू परिदृश्य | प्रमाणीकरण विधि |
|---|---|---|---|
| क्लाउड संस्करण | https://api.dify.ai/v1 |
प्रोटोटाइप सत्यापन, छोटी टीम का उत्पादन | एपीआई कुंजी (बेयरर टोकन) |
| सामुदायिक संस्करण स्व-होस्टेड | http://<your-domain>/v1 |
डेटा संवेदनशील परिदृश्य, उत्पादन परिनियोजन | एपीआई कुंजी (बेयरर टोकन) |
| एंटरप्राइज़ संस्करण का निजीकरण | एंटरप्राइज़ आईटी विभाग द्वारा प्रदान किया गया | सख्त अनुपालन आवश्यकताओं वाले परिदृश्य | एपीआई कुंजी + विन्यास योग्य प्रमाणीकरण |
एपीआई प्रमाणन प्रक्रिया:
- Dify कंसोल में एक एप्लिकेशन बनाएं → "एपीआई एक्सेस" पेज दर्ज करें।
ऐप-से शुरू होने वाली एपीआई कुंजी उत्पन्न करने के लिए "कुंजी बनाएं" पर क्लिक करें।- सभी एपीआई अनुरोधों के HTTP हेडर में
प्राधिकरण: वाहक <API_KEY>रखें। - (वैकल्पिक) मॉनिटरिंग पैनल में उपयोगकर्ता अक्षांश द्वारा उपयोग को ट्रैक करने की सुविधा के लिए प्रत्येक अंतिम उपयोगकर्ता के लिए एक स्वतंत्र सत्र टोकन (
उपयोगकर्तापैरामीटर) उत्पन्न करें।
विशिष्ट एकीकरण चरण:
- Dify कंसोल में विज़ुअल ऑर्केस्ट्रेशन के साथ AI वर्कफ़्लोज़ बनाएं।
- एप्लिकेशन प्रकाशित करें और एपीआई कुंजी प्राप्त करें।
- उपयोगकर्ता इनपुट और संदर्भ चर को पास करते हुए, बाहरी सिस्टम में HTTP क्लाइंट के माध्यम से Dify API को कॉल करें।
- रिस्पॉन्स_मोड पैरामीटर के अनुसार सिंक्रोनस वेटिंग (ब्लॉकिंग) या एसिंक्रोनस कॉलबैक (स्ट्रीमिंग/कॉलबैक) का चयन करें।
- एपीआई द्वारा लौटाए गए JSON प्रतिक्रिया को पार्स करें और परिणामों को अपने यूआई में प्रदर्शित करें।
एसडीके समर्थन (उदाहरण के तौर पर पायथन को लेते हुए):
आयात अनुरोध
API_KEY = "<आपका_API_KEY>"
BASE_URL = "https://api.dify.ai/v1"
हेडर = {
"प्राधिकरण": f"वाहक {API_KEY}",
"सामग्री-प्रकार": "एप्लिकेशन/जेसन"
}
# वार्तालाप संदेश भेजें
प्रतिक्रिया = अनुरोध.पोस्ट(
f"{BASE_URL}/चैट-संदेश",
हेडर = हेडर,
json={
"इनपुट": {},
"क्वेरी": "आज क्या खबर है?",
"प्रतिक्रिया_मोड": "अवरुद्ध करना",
"उपयोगकर्ता": "उपयोगकर्ता-123"
}
)
प्रिंट(प्रतिक्रिया.json()["उत्तर"])
टिप: एसडीके के विशिष्ट इंस्टॉलेशन कमांड और पूर्ण विधि हस्ताक्षर Dify के आधिकारिक GitHub रिपॉजिटरी और PyPI/npm पेज के अधीन हैं। जब सामुदायिक संस्करण स्व-होस्ट किया जाता है, तो सुनिश्चित करें कि एपीआई गेटवे HTTPS प्रमाणपत्र और सही रिवर्स प्रॉक्सी नियमों के साथ कॉन्फ़िगर किया गया है।
उत्पाद का मूल्य निर्धारण
Dify API को अलग से बिल नहीं किया जाता है और इसकी कीमत Dify प्लेटफ़ॉर्म पैकेज में शामिल है। इसका मतलब यह है कि एपीआई कॉल कोटा योजना-स्तरीय संदेश/कॉल वॉल्यूम कैप से जुड़ा हुआ है।
सामुदायिक संस्करण (ओपन सोर्स सेल्फ-होस्टेड):
- एपीआई शुल्क: $0
- सीमाएँ: कोई एपीआई कॉल सीमा नहीं (स्वयं तैनात सर्वर प्रदर्शन द्वारा सीमित)
- शर्त: आपको एपीआई गेटवे HTTPS प्रमाणपत्र एपीआई कुंजी प्रबंधन को स्वयं कॉन्फ़िगर करना होगा
- इन पर लागू: संचालन और रखरखाव क्षमताओं वाली तकनीकी टीमें
क्लाउड मुक्त संस्करण:
- एपीआई शुल्क: $0
- सीमाएँ: प्रति दिन 200 संदेश (एपीआई + वेब कंसोल साझा कोटा), अधिकतम 5 ऐप्स
- लागू: व्यक्तिगत सत्यापन, प्रोटोटाइप विकास
क्लाउड प्रो ($59/माह/कार्यक्षेत्र):
- एपीआई शुल्क: सदस्यता में शामिल है
- सीमाएँ: कोई संदेश सीमा नहीं, 50 अनुप्रयोग, प्राथमिकता तकनीकी सहायता
- इसके लिए उपयुक्त: छोटी टीमों द्वारा उत्पादन का उपयोग
क्लाउड टीम संस्करण ($159/माह से):
- एपीआई शुल्क: सदस्यता में शामिल है
- सीमाएँ: बहु-सदस्यीय सहयोग, उन्नत अनुमति प्रबंधन, अधिक अनुप्रयोग और ज्ञान आधार कोटा
- इन पर लागू: मध्यम आकार की टीमें समानांतर में कई परिदृश्य चला रही हैं
एंटरप्राइज़ संस्करण (अनुकूलित कोटेशन):
- एपीआई शुल्क: एंटरप्राइज़ संस्करण अनुबंध में शामिल है
- सीमाएँ: कस्टम एपीआई दर सीमाएँ, समर्पित एसएलए, एसएसओ एकीकरण, ऑडिट लॉग
- लागू: वित्त, चिकित्सा देखभाल, सरकारी मामले आदि जैसे विनियमित उद्योग।
अतिरिक्त शुल्क: सभी पैकेजों के लिए मॉडल एपीआई कॉलिंग शुल्क सीधे डेवलपर द्वारा मॉडल आपूर्तिकर्ता (जैसे ओपनएआई, डीपसीक, एंथ्रोपिक) को भुगतान किया जाता है, और डिफाई प्लेटफॉर्म और एपीआई परत के लिए कोई अतिरिक्त कमीशन नहीं है। लागत अनुमान में बजट में "डिफाई पैकेज शुल्क + मॉडल एपीआई शुल्क" दोनों को शामिल करने की सिफारिश की गई है।
अनुप्रयोग परिदृश्य
Dify API के एप्लिकेशन परिदृश्यों को "मौजूदा सिस्टम में AI क्षमताओं को एम्बेड करना" के रूप में संक्षेपित किया जा सकता है - कोई भी परिदृश्य जहां मौजूदा प्रौद्योगिकी स्टैक को प्रतिस्थापित किए बिना AI ऑर्केस्ट्रेशन क्षमताओं को पेश करने की आवश्यकता है, Dify API में हस्तक्षेप करने की गुंजाइश है।
-
मौजूदा प्रणालियों का एआई फ़ंक्शन विस्तार: सीआरएम, ईआरपी, वर्क ऑर्डर सिस्टम और सामग्री प्रबंधन प्रणालियों में एआई क्षमताओं को एम्बेड करें, और बुद्धिमान क्यू एंड ए, सामग्री निर्माण और डेटा वर्गीकरण जैसे कार्यों को पूरा करने के लिए एपीआई के माध्यम से डिफाइ वर्कफ़्लो को कॉल करें। कार्यान्वयन लाभ: मौजूदा सिस्टम में न्यूनतम घुसपैठ - सिस्टम आर्किटेक्चर को संशोधित करने की कोई आवश्यकता नहीं है, बस व्यावसायिक तर्क में HTTP कॉल जोड़ें। कटौती से पता चलता है कि एक मध्यम आकार के ई-कॉमर्स बैकएंड को एआई ग्राहक सेवा एपीआई से जोड़ने के बाद, प्रथम-स्तरीय कार्य ऑर्डर के लिए स्वचालित प्रतिक्रिया दर 55-70% तक पहुंच सकती है, और मैन्युअल ग्राहक सेवा प्रसंस्करण मात्रा मूल के 40% तक कम हो जाती है।
-
स्व-निर्मित ज्ञान आधार Q&A एप्लिकेशन: Dify API के दस्तावेज़ प्रबंधन एंडपॉइंट के माध्यम से बैचों में आंतरिक कॉर्पोरेट दस्तावेज़ अपलोड करें, खोज एंडपॉइंट के माध्यम से प्रासंगिक Q&A पुनर्प्राप्ति लागू करें, और सत्र प्रबंधन एंडपॉइंट के माध्यम से बातचीत के कई दौर बनाए रखें। कार्यान्वयन लाभ: एक विशिष्ट एचआर ज्ञान आधार परिदृश्य में, कर्मचारियों के लिए ऑनबोर्डिंग प्रक्रिया, छुट्टी नीति और अन्य सामान्य मुद्दों पर स्वयं-सेवा क्वेरी का समय औसतन 10 मिनट (दस्तावेज़ों को पलटना + सहकर्मियों से पूछना) से घटाकर 30 सेकंड से भी कम कर दिया जाता है।
-
स्वचालित सामग्री उत्पादन पाइपलाइन: Dify वर्कफ़्लो को एक सामग्री उत्पादन पाइपलाइन (विषय चयन → डेटा संग्रह → पहला ड्राफ्ट जनरेशन → समीक्षा → रिलीज़) में व्यवस्थित करें, और एपीआई के माध्यम से सीएमएस सिस्टम से जुड़ें। कार्यान्वयन लाभ: नई मीडिया ऑपरेशन टीमों के लिए, एक मानक सार्वजनिक खाता लेख का पहला ड्राफ्ट उत्पादन समय 60-90 मिनट से घटाकर 10-15 मिनट कर दिया गया है, लेकिन तथ्यात्मक सटीकता और ब्रांड टोनलिटी स्थिरता सुनिश्चित करने के लिए मैन्युअल समीक्षा को बनाए रखने की आवश्यकता है।
-
क्रॉस-सिस्टम एआई एजेंट एकीकरण: डिफाई एपीआई के एजेंट वर्कफ़्लो एंडपॉइंट के माध्यम से, जटिल एआई कार्यों को कई व्यावसायिक प्रणालियों के बीच व्यवस्थित किया जाता है - उदाहरण के लिए, एक "ग्राहक शिकायत प्रसंस्करण एजेंट": ग्राहक जानकारी पूछने के लिए सीआरएम एपीआई को कॉल कर सकता है → प्रासंगिक शिकायत मामलों को पुनः प्राप्त करने के लिए ज्ञान आधार को कॉल कर सकता है → प्रतिक्रिया सुझाव उत्पन्न करने के लिए एलएलएम को कॉल कर सकता है → प्रोसेसिंग वर्क ऑर्डर बनाने के लिए वर्क ऑर्डर सिस्टम को कॉल कर सकता है। कार्यान्वयन लाभ: सरल शिकायतों का पूर्ण-लिंक स्वचालित प्रसंस्करण, जटिल शिकायतें स्वचालित रूप से मैन्युअल समीक्षा के लिए ड्राफ्ट हैंडलिंग सुझाव उत्पन्न करती हैं, और एक शिकायत का प्रसंस्करण समय घंटों से कम होकर मिनटों में हो जाता है।
-
उद्यम की आंतरिक उपकरण श्रृंखला का एआई संवर्द्धन: एआई सहायक रोबोट प्रदान करने के लिए कॉरपोरेट वीचैट, फेशू और डिंगटॉक जैसे कार्यालय प्लेटफार्मों में डिफाई एपीआई को एकीकृत करें। एपीआई की सत्र प्रबंधन क्षमताओं के माध्यम से, क्रॉस-प्लेटफ़ॉर्म वार्तालाप संदर्भ साझाकरण प्राप्त किया जा सकता है - उपयोगकर्ता वीचैट एंटरप्राइज में फ़ेशू पर प्रश्न पूछना जारी रख सकते हैं। लागू सीमा: क्रॉस-प्लेटफ़ॉर्म संदर्भ साझाकरण के लिए बाहरी सत्र प्रबंधन प्रणाली के समर्थन की आवश्यकता होती है, और शुद्ध एपीआई मोड सीधे संदेश रूटिंग समस्या का समाधान नहीं करता है।
लागत में कमी और दक्षता में सुधार की मात्रात्मक कटौती (Dify एपीआई सुविधाओं के आधार पर अनुमान)
| नौकरी की भूमिकाएँ | विशिष्ट कार्य | पारंपरिक तरीकों से समय लेने वाला | एपीआई एकीकरण के बाद समय लेने वाला | दक्षता में सुधार | कटौती निर्देश |
|---|---|---|---|---|---|
| ग्राहक सेवा विशेषज्ञ | क्वेरी मानक रिटर्न और विनिमय प्रक्रिया | 3-5 मिनट (दस्तावेज़ पलटना) | 10-15 सेकंड (एपीआई प्रश्नोत्तर) | 12-30 बार | ज्ञान आधार खोज + एलएलएम पीढ़ी पर आधारित आरएजी एपीआई लिंक |
| सामग्री संचालन | उत्पाद परिचय प्रति उत्पन्न करें | 60-90 मिनट | 10-15 मिनट (पहला ड्राफ्ट) | 4-6 बार | वर्कफ़्लो एपीआई बहु-चरणीय सामग्री उत्पादन पाइपलाइन को ट्रिगर करता है |
| कानूनी सहायक | अनुबंध शर्तों की प्रारंभिक समीक्षा | 2-4 घंटे | 15-30 मिनट (पूर्व-समीक्षा) | 4-8 बार | शब्दों की तुलना पूरी करने के लिए वर्कफ़्लो एपीआई + नॉलेज बेस सर्च एपीआई संयोजन |
| विकास अभियंता | AI Q&A को मौजूदा सिस्टम में एकीकृत करें | 2-3 दिन (स्वयं निर्मित एलएलएम पाइपलाइन) | 2-4 घंटे (एपीआई डॉकिंग) | 6-12 बार | Dify API मॉडल एक्सेस, RAG निर्माण, सत्र प्रबंधन आदि की आवश्यकता को समाप्त करता है |
उपरोक्त डेटा Dify API की कार्यात्मक विशेषताओं पर आधारित एक सैद्धांतिक कटौती है और यह कोई आधिकारिक प्रतिबद्धता नहीं है। वास्तविक सुधार वर्कफ़्लो जटिलता, ज्ञान आधार गुणवत्ता, मॉडल चयन और एपीआई प्रतिक्रिया समय पर निर्भर करता है।
मानव-मशीन सहयोग की सीमा
Dify API की स्वचालन क्षमताएं विभिन्न अनुभागों में हस्तक्षेप की गहराई में भिन्न होती हैं:
- 100% स्वचालित और खंडित: ज्ञान आधार पुनर्प्राप्ति, दस्तावेज़ वर्गीकरण, पाठ सारांश, स्वरूपित रिपोर्ट निर्माण, स्वचालित वर्गीकरण और कार्य आदेशों का रूटिंग। ये संरचित आउटपुट सत्यापन योग्य हैं और विफल होने पर अपरिवर्तनीय क्षति नहीं पहुंचाएंगे।
- लेख जहां मैन्युअल पुष्टिकरण बिंदु निर्धारित किए जाने चाहिए: अनुबंध शर्तों की समीक्षा निष्कर्ष, ग्राहक शिकायत प्रबंधन योजना, भुगतान/धनवापसी निर्देश, ऑनलाइन सामग्री जारी करना, और कानूनी प्रभाव या वित्तीय संचालन से संबंधित कोई भी एआई आउटपुट। Dify वर्कफ़्लो में "सशर्त शाखा" नोड ऐसे परिदृश्यों में "मैनुअल समीक्षा" पथ स्थापित कर सकता है - AI सुझाव उत्पन्न करता है और फिर उन्हें मैन्युअल पुष्टिकरण कतार में रूट करता है, और फिर पुष्टि के बाद बाद के संचालन करता है।
लागू लोग
Dify API एक ऐसी आबादी को लक्षित करता है जो Dify प्लेटफ़ॉर्म के लिए अत्यधिक प्रासंगिक है, लेकिन कौशल आवश्यकताओं और अनुमति स्तरों में महत्वपूर्ण अंतर हैं।
-
बैकएंड/फुल स्टैक डेवलपर्स: कोर उपयोगकर्ता समूह। जिन डेवलपर्स को एआई क्षमताओं को मौजूदा सिस्टम में एकीकृत करने की आवश्यकता है, वे एपीआई प्रतिक्रिया, दस्तावेज़ीकरण पूर्णता, त्रुटि प्रबंधन तंत्र और एसडीके गुणवत्ता के बारे में चिंतित हैं। अनुकूलन मूल्य: Dify API डेवलपर्स को अपनी स्वयं की LLM पाइपलाइन बनाए बिना HTTP कॉल के माध्यम से पूर्ण AI ऑर्केस्ट्रेशन क्षमताएं प्राप्त करने की अनुमति देता है (एजेंट ऑर्केस्ट्रेशन बनाने के लिए मॉडल RAG से जुड़ा है)। सीमा में फिट नहीं होना: यदि प्रोजेक्ट को केवल एक साधारण एलएलएम कॉल (जैसे पाठ के एक टुकड़े का अनुवाद करना) की आवश्यकता है, तो मॉडल प्रदाता एपीआई को सीधे कॉल करना Dify एपीआई के माध्यम से जाने से अधिक सरल है, जिसकी ऑर्केस्ट्रेशन परत यहां अत्यधिक अमूर्त है।
-
DevOps/प्लेटफ़ॉर्म इंजीनियर्स: Dify स्व-होस्टेड परिनियोजन और API गेटवे संचालन के लिए जिम्मेदार टीम। वे एपीआई स्थिरता, अवलोकन क्षमता (लॉग, मॉनिटरिंग, अलार्म), स्केलेबिलिटी और सुरक्षा कॉन्फ़िगरेशन की परवाह करते हैं। अनुकूलन मूल्य: Dify API का अतुल्यकालिक निष्पादन मोड और वेबहुक कॉलबैक तंत्र दीर्घकालिक कार्यों के संचालन और रखरखाव की जटिलता को कम करता है; एंटरप्राइज़ संस्करण के ऑडिट लॉग और एसएसओ एकीकरण अनुपालन आवश्यकताओं को पूरा करते हैं। सीमाओं के लिए उपयुक्त नहीं: तंग जीपीयू संसाधनों वाली टीमों के लिए या कंटेनरीकृत तैनाती में कोई अनुभव नहीं होने पर, स्व-होस्टेड डिफाई एपीआई की संचालन और रखरखाव लागत क्लाउड संस्करण सदस्यता शुल्क से अधिक हो सकती है। निर्णय लेने से पहले श्रम लागत और आर्थिक लागत की तुलना करने की अनुशंसा की जाती है।
-
तकनीकी उत्पाद प्रबंधक/समाधान वास्तुकार: निर्णय-निर्माता जो व्यावसायिक परिदृश्यों के लिए एआई एकीकरण समाधान डिजाइन करता है। वे एपीआई क्षमता सीमाओं, मौजूदा प्रौद्योगिकी स्टैक के साथ अनुकूलता, विक्रेता लॉक-इन के जोखिम और डेटा संप्रभुता के बारे में चिंतित हैं। अनुकूलन मूल्य: Dify API का "एक ऑर्केस्ट्रेशन, एकाधिक कॉल" मॉडल कई प्रणालियों के बीच AI कार्यों के डुप्लिकेट निर्माण की लागत को कम करता है; ओपन सोर्स और सेल्फ-होस्टिंग सुविधा विक्रेता लॉक-इन के बारे में चिंताओं को समाप्त करती है। मिसफिट सीमा: यदि व्यावसायिक आवश्यकता एआई क्षमताओं को एकीकृत करने के बजाय एक आउट-ऑफ़-द-बॉक्स SaaS उत्पाद खरीदने की है, तो Dify API एक उपयुक्त विकल्प नहीं है - इस समय, Dify Cloud के वेब एप्लिकेशन या समान SaaS उत्पादों को प्राथमिकता दी जानी चाहिए।
-
एआई एप्लीकेशन एंटरप्रेन्योरशिप टीम: एक प्रारंभिक टीम जो एआई उत्पाद विचारों को तुरंत सत्यापित करती है। अनुकूलन मूल्य: डिफाई एपीआई तैयार एआई ऑर्केस्ट्रेशन बुनियादी ढांचा प्रदान करता है, ताकि टीमें व्यावसायिक तर्क और उपयोगकर्ता अनुभव पर संसाधनों पर ध्यान केंद्रित कर सकें। लागू नहीं: जब उपयोगकर्ताओं की संख्या उस बिंदु तक बढ़ जाती है जहां चरम एपीआई प्रदर्शन अनुकूलन (जैसे मिलीसेकंड-स्तरीय प्रतिक्रिया) या गहराई से अनुकूलित वर्कफ़्लो इंजन व्यवहार की आवश्यकता होती है, तो डिफाई एपीआई की अमूर्त परत एक बाधा बन सकती है - उस समय, यह मूल्यांकन करना आवश्यक है कि क्या स्व-निर्मित पाइपलाइन पर माइग्रेट करना आवश्यक है।
सारांश और आउटलुक
Dify API, Dify प्लेटफ़ॉर्म के लिए "आंतरिक ऑर्केस्ट्रेशन टूल्स" से "प्लेटफ़ॉर्म इंफ्रास्ट्रक्चर" में जाने के लिए प्रमुख उत्पाद परत है। इसकी मुख्य प्रतिस्पर्धात्मकता "एकीकृत निष्पादन रनटाइम + पूर्ण एपीआई कवरेज + ओपन सोर्स और सेल्फ-होस्टिंग" के संयोजन में निहित है - डेवलपर्स को "पूर्ण फ़ंक्शन लेकिन बंद स्रोत" (कोज़ एपीआई) और "ओपन सोर्स लेकिन बिखरे हुए फ़ंक्शन" (फ्लोवाइज/लैंगफ्लो) के बीच चयन करने की आवश्यकता नहीं है।
मुख्य लाभ: Dify API और वेब कंसोल एक ही निष्पादन इंजन साझा करते हैं, जिससे परीक्षण और उत्पादन के बीच विसंगतियां दूर हो जाती हैं; एपीआई एंडपॉइंट संपूर्ण वर्कफ़्लो आरएजी, एजेंट और मॉडल प्रबंधन लिंक को कवर करते हैं, और एक एकल प्लेटफ़ॉर्म अधिकांश एआई ऑर्केस्ट्रेशन आवश्यकताओं को पूरा करता है; ओपन सोर्स समुदाय संस्करण को असीमित डेटा संप्रभुता के साथ स्व-होस्ट किया जा सकता है।
वर्तमान सीमाएँ: एपीआई स्तर पर उन्नत प्रबंधन कार्य (बारीक आरबीएसी, बहु-किरायेदार अलगाव, कस्टम दर नीतियां) केवल एंटरप्राइज़ संस्करण में उपलब्ध हैं, और सामुदायिक संस्करण और क्लाउड संस्करण के बीच सुरक्षा प्रशासन में अंतर है; दस्तावेज़ प्रबंधन एपीआई बैच अपलोड और वृद्धिशील सिंक्रनाइज़ेशन के लिए परमाणु संचालन का समर्थन नहीं करता है, और बड़े पैमाने पर ज्ञान आधार निर्माण के लिए बाहरी ऑर्केस्ट्रेशन की आवश्यकता होती है; एसडीके में सीमित कवरेज भाषाएं हैं (केवल पायथन और जेएस आधिकारिक तौर पर बनाए रखा गया है), और अन्य भाषाएं सामुदायिक योगदान पर निर्भर हैं।
अनुवर्ती अवलोकन बिंदु: एजेंट आर्किटेक्चर अपग्रेड के बाद, क्या एपीआई परत स्वतंत्र रूप से एजेंट-विशिष्ट एंडपॉइंट प्रकाशित करेगी; क्या एंटरप्राइज़ संस्करण एपीआई जटिल मल्टी-डेटा स्रोत क्वेरी परिदृश्यों को पूरा करने के लिए ग्राफक्यूएल समर्थन जोड़ेगा; क्या एपीआई के ओपनएपीआई विनिर्देश को प्लेटफ़ॉर्म संस्करण के साथ समकालिक रूप से अपडेट किया जा सकता है (वर्तमान में एक निश्चित अंतराल है)।
खरीद/गोद लेने का जोखिम मूल्यांकन: प्रौद्योगिकी चयन चरण में, यह सत्यापित करने के लिए पहले क्लाउड फ्री संस्करण का उपयोग करने की अनुशंसा की जाती है कि एपीआई क्षमताएं और प्रतिक्रिया विलंबता व्यावसायिक आवश्यकताओं को पूरा करती है या नहीं। सत्यापन पास करने के बाद, आप क्लाउड प्रोफेशनल संस्करण या स्वयं-होस्ट किए गए सामुदायिक संस्करण का उपयोग करने का निर्णय ले सकते हैं। सख्त अनुपालन आवश्यकताओं वाले मध्यम और बड़े उद्यमों के लिए, उन्हें एंटरप्राइज़ संस्करण अनुबंध पर हस्ताक्षर करने से पहले निम्नलिखित शर्तों को सत्यापित करने पर ध्यान केंद्रित करने की आवश्यकता है: एपीआई एसएलए गारंटी दायरा (जैसे मासिक उपलब्धता समय, टाइमआउट पुनः प्रयास तंत्र, विफलता पुनर्प्राप्ति समय लक्ष्य), डेटा भंडारण स्थान और डेटा हटाने की नीति। एपीआई कुंजी लीक होने के बाद जिम्मेदारी साझा करने का तंत्र। उद्यमशील टीमों के लिए, "डिफाई एपीआई ऑर्केस्ट्रेशन परत है, और मॉडल एपीआई शुल्क मुख्य लागत है" के बारे में बजट जागरूकता स्थापित की जानी चाहिए - जैसे-जैसे उपयोग बढ़ता है, मॉडल कॉलिंग शुल्क डिफि पैकेज शुल्क से कहीं अधिक होगा, और मॉडल चयन और लागत अनुकूलन रणनीतियों को प्रारंभिक चरण में योजना बनाने की आवश्यकता है (जैसे कि सरल कार्यों को संभालने के लिए लागत प्रभावी मॉडल का उपयोग करना, और संदर्भ कैशिंग के माध्यम से बार-बार इनपुट लागत को कम करना)।
संबंधित उपकरण: <एक्सलिंक प्रकार='टूल' स्लग='क्रूवाई'>, <एक्सलिंक प्रकार='टूल' स्लग='लैंगचेन'>
संस्करण जानकारी
- Dify एपीआई v1.14.2 :सुरक्षा सख्त करना और बग फिक्स करना, एजेंट अंतर्निहित वास्तुकला में सुधार, वर्कफ़्लो एपीआई विश्वसनीयता में सुधार, और स्व-होस्टेड परिनियोजन अनुकूलन। एपीआई स्तर प्लेटफ़ॉर्म v1.14.2 की स्थिरता में सुधार के साथ सिंक्रनाइज़ होता है।
- Dify एपीआई v1.14.1 :सुरक्षा सख्त करना, वर्कफ़्लो एपीआई स्थिरता में सुधार, और स्व-होस्टेड परिनियोजन क्लीनअप।
- Dify एपीआई v1.14.0 :मुख्य संस्करण फ़ंक्शन को अपडेट कर दिया गया है, और एजेंट ऑर्केस्ट्रेशन से संबंधित एंडपॉइंट को एपीआई स्तर पर एक साथ जोड़ा गया है। कृपया आधिकारिक चेंजलॉग देखें।
- Dify API v1.0 आधिकारिक संस्करण :इस मील के पत्थर संस्करण में, एपीआई परत ने आधिकारिक तौर पर उत्पादन-तैयार चरण में प्रवेश किया है, जो संपूर्ण आरईएसटी एपीआई कवरेज और ओपनएपीआई विनिर्देश दस्तावेज प्रदान करता है।
उपयोगकर्ता समीक्षाएं