Dify BetterToken सेटअप: API key, Base URL और कस्टम मॉडल

Dify को BetterToken से कनेक्ट करने के लिए API key तैयार करें, नीचे दिया Base URL भरें और model plaza से वर्तमान Model ID चुनें।

मुख्य सेटिंग्स

फ़ील्ड	मान
API Key	BetterToken API key
Base URL	https://bettertoken.ai/v1
मॉडल	model plaza से वर्तमान Model ID

आवश्यकताएं

• टूल का वर्तमान संस्करण इंस्टॉल है
• BetterToken API key: रजिस्टर करें और प्राप्त करें
• model plaza से Model ID

साइन अप करें और BetterToken API Key पाएँ→

पहले से खाता है? साइन इन करें, रिचार्ज करें, फिर कंसोल में कुंजी बनाएँ।

अतिरिक्त आवश्यकताएं

• Dify Cloud या प्लगइन चालू वाला self-hosted Dify instance
• मॉडल प्लगइन इंस्टॉल करने और workspace मॉडल प्रबंधित करने की अनुमति

यह गाइड केवल LLM Chat कॉन्फ़िगर करती है। GPT chat मॉडल को Text Embedding, Rerank, Speech-to-Text या Text-to-Speech के रूप में न जोड़ें।

इंस्टॉल करें

OpenAI-compatible मॉडल प्लगइन इंस्टॉल करें

Model Providers खोलें

Dify workspace में Integrations > Model Providers पर जाएं।

आधिकारिक प्लगइन इंस्टॉल करें

Install model providers पर क्लिक करें, OpenAI-API-compatible खोजें और इंस्टॉल करें।

Dify मॉडल provider को workspace-level प्लगइन के रूप में प्रबंधित करता है। इंस्टॉल करने के बाद, जरूरी workspace अनुमति वाले ऐप इस provider से मॉडल चुन सकते हैं।

कस्टम मॉडल जोड़ें

OpenAI-API-compatible कार्ड पर Add Model क्लिक करें। यदि कार्ड पहले Setup या Configure दिखाता है, तो उसे खोलें और मॉडल जोड़ने का विकल्प चुनें।

मैन्युअल सेटअप

यह सेटअप Dify model-provider UI में पूरा करें। आपको configuration फ़ाइल संपादित करने की जरूरत नहीं है।

फ़ील्ड	मान
API Key	BetterToken API key
Base URL	https://bettertoken.ai/v1
मॉडल	model plaza से वर्तमान Model ID

मॉडल configuration भरें

पहले मॉडल के लिए ये मान उपयोग करें:

Dify फ़ील्ड	अनुशंसित मान
Model Type	LLM
Model Name	model plaza से किसी मॉडल ID
Model display name	Model Name जैसा ही मान ठीक है
API Key	आपकी BetterToken API key
API Base URL	https://bettertoken.ai/v1
model name for API endpoint	Model Name जैसी ही मॉडल ID
Completion mode	Chat
Model context size	चुने गए मॉडल से मिलाएं; संदेह होने पर प्लगइन का डिफ़ॉल्ट रखें
Upper bound for max tokens	चुने गए मॉडल की सीमा से अधिक न रखें; पहले परीक्षण में प्लगइन डिफ़ॉल्ट रखें
Compatibility mode	OpenAI compatible / strict
Token parameter name	Auto
Function Call Type	पहले परीक्षण के लिए Not Support

API Base URL में केवल https://bettertoken.ai/v1 भरें। /chat/completions न जोड़ें; Dify प्लगइन जरूरी endpoint को कॉल करता है।

बाकी वैकल्पिक क्षमताओं के लिए सुरक्षित मान रखें:

• Thinking Mode Support: मॉडल समर्थन की पुष्टि के बाद ही चालू करें
• Stream function calling: पहले परीक्षण के लिए Not Support चुनें
• Vision Support: केवल तब चालू करें जब मॉडल और endpoint दोनों image input स्वीकार करें
• Structured Output: plain chat काम करने तक इसे बंद रखें

Include Usage in Stream (stream_include_usage) को उसके डिफ़ॉल्ट Enabled पर रखें। यह अंतिम stream chunk में token counts माँगने के लिए stream_options: {include_usage: true} जोड़ता है; endpoint इस फ़ील्ड को अस्वीकार करे तभी इसे बंद करें। Stream mode auth (stream_mode_auth) का डिफ़ॉल्ट Not Use है; Use चुनने पर credentials की जाँच streaming request से होती है, सामान्य generation settings नहीं बदलतीं। आधिकारिक provider फ़ील्ड देखें।

Save पर क्लिक करें। Dify API Key, Base URL और मॉडल ID की जांच करता है।

ऐप में मॉडल इस्तेमाल करें

Dify ऐप बनाएं या खोलें

Chatbot, Agent, Chatflow या Workflow खोलें।

मॉडल चुनें

ऐप model selector या LLM node में, OpenAI-API-compatible के अंतर्गत जोड़ा गया मॉडल चुनें।

पहले plain chat जांचें

पहला अनुरोध छोटे text input और बिना tool या image के चलाएं:

Reply with exactly: Connection successful

बाद में Agent क्षमताएं चालू करें

plain chat चलने के बाद यदि tool call चाहिए तो मॉडल configuration संपादित करें। Function Call Type को मॉडल समर्थित mode पर सेट करें। OpenAI-compatible tool calling सामान्यतः Tool Call उपयोग करती है, लेकिन चुने मॉडल और endpoint के समर्थन की पुष्टि जरूरी है।

कनेक्शन सत्यापित करें

छोटा test prompt भेजें। यदि टूल बिना authentication या Model ID त्रुटि के उत्तर देता है, तो कनेक्शन काम कर रहा है। configuration बदलने के बाद टूल को पूरी तरह रीस्टार्ट करें।

मॉडल बदलें

मॉडल selector खोलें या configuration में Model फ़ील्ड बदलें। model plaza से सटीक Model ID उपयोग करें, फिर मौजूदा session रीस्टार्ट करें।

Dify हर मॉडल ID के लिए कस्टम configuration रखता है। समर्थित provider से दूसरा मॉडल जोड़ने के लिए उसी provider में फिर Add Model क्लिक करें। नई ID को Model Name और model name for API endpoint दोनों में उपयोग करें। आप Base URL और API Key फिर से उपयोग कर सकते हैं।

सामान्य त्रुटियां

सहेजने पर 401 मिलता है

• जांचें कि API Key पूरी है
• model plaza से सही Model ID कॉपी करें।
• BetterToken Dashboard में key की स्थिति और balance जांचें

सहेजने पर 404 मिलता है

• API Base URL https://bettertoken.ai/v1 होना चाहिए
• /chat/completions न जोड़ें
• सुनिश्चित करें कि model name for API endpoint model plaza ID से बिल्कुल मेल खाता है

Dify में model not found दिखता है

Model Name Dify के मॉडल दिखाने और चुनने के तरीके को प्रभावित कर सकता है। वास्तविक अनुरोध मॉडल को model name for API endpoint नियंत्रित करता है। दोनों फ़ील्ड में समर्थित provider की वही मॉडल ID उपयोग करें।

Plain chat चलता है, लेकिन Agent tool विफल होते हैं

Function Call Type को वापस Not Support पर सेट करें और बुनियादी LLM node जांचें। इसे Tool Call पर केवल तब बदलें जब चुना गया मॉडल tool calling समर्थित हो, फिर tool argument दोबारा जांचें।

Knowledge इस मॉडल को Embedding Model के रूप में उपयोग नहीं कर सकता

यह अपेक्षित है। chat LLM embedding मॉडल की जगह नहीं ले सकता। यह गाइड Dify के लिए BetterToken embedding या rerank endpoint की पुष्टि नहीं करती; Knowledge के लिए अलग से समर्थित embedding provider कॉन्फ़िगर करें।

उन्नत सेटअप

संबंधित गाइड

• Dify Model Providers

• Dify आधिकारिक OpenAI-API-compatible प्लगइन

• OpenAI-compatible API बनाम Anthropic-compatible API

• मॉडल कैसे चुनें

• सभी समर्थित टूल की तुलना करें

• API त्रुटियाँ, status codes और rate limits

तकनीकी विवरण

Protocol, endpoint और आंतरिक provider फ़ील्ड

यह सेटअप https://bettertoken.ai/v1 उपयोग करता है। टूल OpenAI-compatible endpoint path जोड़ता है। जब तक कोई विशेष फ़ील्ड स्पष्ट रूप से न मांगे, /chat/completions या /responses न जोड़ें।