Cherry Studio + JoinGonka Gateway — डेस्कटॉप AI-क्लाइंट

Cherry Studio — Windows, macOS और Linux के लिए एक ओपन डेस्कटॉप AI-क्लाइंट: सहायकों के साथ चैट, कई मॉडलों के उत्तरों की तुलना, एजेंट, ज्ञान का आधार, अनुवाद और MCP-सर्वर को जोड़ना। प्रोजेक्ट AGPL-3.0 लाइसेंस के तहत वितरित किया जाता है और इसने GitHub पर 50 हजार से अधिक स्टार एकत्र किए हैं (सितंबर 2026)। क्लाइंट का मुख्य सिद्धांत है: अपनी कुंजियाँ: आप स्वयं तय करते हैं कि inference किन प्रदाताओं के माध्यम से होता है, और एप्लिकेशन उनके ऊपर एक एकीकृत इंटरफ़ेस प्रदान करता है।

प्रदाताओं की तैयार सूची के अलावा, Cherry Studio में Custom Provider उपलब्ध है — किसी भी पते वाला अपना प्रदाता। इसके माध्यम से JoinGonka Gateway जुड़ता है: Gonka विकेंद्रीकृत नेटवर्क के मॉडलों के लिए OpenAI-संगत API, नेटवर्क की लाइव कीमतों पर टोकन द्वारा भुगतान के साथ। पंजीकरण और पता पुष्टिकरण के बाद खाते में 3M मुफ्त टोकन आएंगे — पहले रिचार्ज से पहले आप क्लाइंट को आराम से आज़मा सकते हैं।

गाइड में V1 के लिए नोट्स के साथ मौजूदा V2 श्रृंखला के लिए चरण-दर-चरण सेटअप, # प्रतीक के बारे में नियम के साथ API Host फ़ील्ड का विश्लेषण, मॉडल चयन, चेक और सामान्य त्रुटियां शामिल हैं। इंटरफ़ेस के हस्ताक्षर एप्लिकेशन के अंग्रेजी स्थानीयकरण के अनुसार दिए गए हैं।

इंस्टॉलेशन, संस्करण और कुंजी

इंस्टॉलेशन। सभी सिस्टम के बिल्ड प्रोजेक्ट के रिलीज़ पेज पर हैं: Windows के लिए इंस्टॉलर और पोर्टेबल बिल्ड, macOS के लिए dmg इमेज, Linux के लिए AppImage, deb और rpm — x64 और ARM दोनों के लिए। चैट इतिहास और सेटिंग्स आपकी मशीन पर लोकल रहती हैं।

V1 या V2। अगस्त 2026 में V2 लाइन आई, नई डेटा संरचना और नए सिरे से बनी सेटिंग्स के साथ; पिछली लाइन का आख़िरी बिल्ड 1.9.13 है। कस्टम प्रोवाइडर दोनों में है, फ़र्क़ सिर्फ़ जोड़ने के तरीके और कुछ लेबलों का है — नीचे ऐसी जगहें चिह्नित हैं। V1 से अपग्रेड करने पर प्रोवाइडर और मॉडल की सेटिंग्स अपने आप चली जाती हैं, V1 का मूल डेटा सुरक्षित रहता है, लेकिन नया डेटा वापस सिंक नहीं होता, और दोनों लाइनों के बैकअप असंगत हैं। अपडेट से पहले Cherry Studio डॉक्युमेंटेशन में माइग्रेशन वाला सेक्शन पढ़ें।

JoinGonka की कुंजी। गेटवे पर रजिस्टर करें, डैशबोर्ड में "API कुंजियाँ" सेक्शन खोलें और "कुंजी बनाएँ" पर क्लिक करें। कुंजी jg- से शुरू होती है और सिर्फ़ एक बार दिखती है — तुरंत सहेज लें। Cherry Studio के लिए अलग कुंजी बनाना बेहतर है: "उपयोग" सेक्शन में उसका खर्च अलग पंक्ति में दिखेगा।

कनेक्शन: अपना प्रदाता और API Host फ़ील्ड

गियर आइकन पर क्लिक करें — सेटिंग्स खुल जाएँगी। Model Provider सेक्शन चुनें (अंग्रेज़ी डॉक्युमेंटेशन में इसे Model Services कहा गया है)।
प्रोवाइडर की सूची के नीचे Add Provider पर क्लिक करें।
V2 में Add Custom Provider डायलॉग खुलेगा। Provider Name लिखें — जैसे JoinGonka। Endpoint settings ब्लॉक में OpenAI वाली लाइन में https://gate.joingonka.ai/v1 पता भरें: फ़ील्ड के नीचे Request path की लाइन दिखेगी जिसमें अंतिम पथ होगा — उसे /v1/chat/completions पर खत्म होना चाहिए। API Key फ़ील्ड में jg-your-key पेस्ट करें और Add दबाएँ।
V1 में डायलॉग छोटा है: प्रोवाइडर का नाम और Provider Type — OpenAI चुनें। की और पता प्रोवाइडर के पेज पर ही, API Key और API Host फ़ील्ड में डाले जाते हैं।
सुनिश्चित करें कि प्रोवाइडर चालू है: टॉगल उसके पेज के ऊपरी दाएँ कोने में है। V2 में नए प्रोवाइडर बंद हालत में जोड़े जाते हैं, और बंद प्रोवाइडर के मॉडल चुनने की सूचियों में नहीं दिखते।

Cherry Studio पता कैसे जोड़ता है। API Host फ़ील्ड बेस पता लेता है, और पथ ऐप खुद जोड़ता है तथा नतीजा फ़ील्ड के नीचे Preview लाइन में दिखाता है। नियम दोनों लाइनों में एक जैसे हैं:

क्या लिखा है	अनुरोध कहाँ जाएगा	टिप्पणी
`https://gate.joingonka.ai/v1`	`https://gate.joingonka.ai/v1/chat/completions`	अनुशंसित विकल्प: पते में वर्ज़न पहले से है, सिर्फ़ पथ जोड़ा जाता है
`https://gate.joingonka.ai`	वही पता	पते में वर्ज़न नहीं है — Cherry Studio खुद `/v1` जोड़ देगा
`https://gate.joingonka.ai/v1/`	वही पता	अंत का स्लैश बस हटा दिया जाता है
`https://gate.joingonka.ai/v1/chat/completions#`	पता जैसा है, `#` के बिना	अंत में `#` वर्ज़न और पथ की ऑटो-सबस्टिट्यूशन बंद कर देता है। गेटवे के लिए यह तरीका फ़ालतू है — यह गैर-मानक पथ वाली सेवाओं के लिए ज़रूरी है
`https://gate.joingonka.ai#`	`https://gate.joingonka.ai/chat/completions`	वर्ज़न नहीं जोड़ा गया, अनुरोध API से बाहर चला जाता है — गेटवे `405` लौटाएगा

पुराने निर्देशों में एक और नियम मिलता है: पते के अंत का स्लैश मानो /v1 को बंद कर देता है। यह शुरुआती वर्ज़न में, 1.6 लाइन तक लागू था, और 1.7 में हटा दिया गया: मौजूदा बिल्ड्स में ऑटो-सबस्टिट्यूशन सिर्फ़ # बंद करता है।

मॉडल: सूची, प्रकार और डिफ़ॉल्ट मॉडल

प्रदाता जोड़ दिया गया है, लेकिन चैट में यह अभी तक दिखाई नहीं दे रहा है: Cherry Studio चयन सूची में केवल वही मॉडल आते हैं जिन्हें आपने स्पष्ट रूप से जोड़ा है। इसके दो तरीके हैं।

सर्वर से सूची। प्रदाता पृष्ठ पर Sync models दबाएं (V1 में — Manage, फिर Fetch model list)। Cherry Studio गेटवे से GET /v1/models का अनुरोध करेगा और नेटवर्क की लाइव संरचना दिखाएगा; + बटन के साथ आवश्यक मॉडल जोड़ें। मैन्युअल रूप से। Add Model बटन एक फ़ॉर्म खोलता है जहां एक फ़ील्ड अनिवार्य है — Model ID: पहचानकर्ता को अक्षर दर अक्षर दर्ज किया जाता है।

नेटवर्क के मॉडल की कीमत समान है, इसलिए सभी को जोड़ें — आपको बजट के बजाय व्यवहार के आधार पर उनके बीच चयन करना होगा:

मॉडल	Model ID	संदर्भ और उत्तर	Cherry Studio में कब लें
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380K, 32768 टोकन तक उत्तर	सहायक मॉडल: लंबे दस्तावेज़, बड़े कोड ब्लॉक, विस्तृत उत्तर और अनुवाद — नेटवर्क में उत्तर की सबसे बड़ी सीमा
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200K, 8192 टोकन तक उत्तर	त्वरित दैनिक प्रश्न, पत्रों के ड्राफ्ट, छोटे टेक्स्ट संपादन; एक सेवा मॉडल के रूप में उपयुक्त
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390K, 8192 टोकन तक उत्तर	Reasoning-मॉडल: उत्तर देने से पहले तर्क करता है। जटिल कार्य का विश्लेषण, योजना, तर्क की जांच; उत्तर बाद में आता है, और उत्तर सीमा का हिस्सा तर्क के लिए उपयोग किया जाता है

मॉडल के प्रकार। सूची में प्रत्येक मॉडल के पास सेटिंग्स बटन होता है, जहां इसकी क्षमताओं को चिह्नित किया जाता है: Vision, Reasoning, Tool और अन्य। Cherry Studio कुछ अंक स्वचालित रूप से सेट करता है, लेकिन गेटवे मॉडल के लिए उन्हें जांचना चाहिए। Vision को हटा दिया जाना चाहिए: नेटवर्क मॉडल टेक्स्ट-आधारित हैं। यदि आप MCP-टूल कनेक्ट कर रहे हैं तो Tool की आवश्यकता है — टेबल के सभी मॉडल नेटिव टूल कॉल का समर्थन करते हैं। Reasoning GLM-5.3 Flash के लिए उपयुक्त है — यह नेटवर्क का reasoning-मॉडल है।

डिफ़ॉल्ट मॉडल। सेटिंग्स अनुभाग Default Model में सेवा भूमिकाओं के लिए मॉडल सेट किए जाते हैं। मुख्य सहायक मॉडल के रूप में DeepSeek V4 Flash रखें। एक त्वरित मॉडल के लिए जो संवादों के शीर्षक तैयार करता है और खोज अनुरोध तैयार करता है, Cherry Studio दस्तावेज़ीकरण एक हल्के और तेज़ मॉडल की सलाह देता है, न कि reasoning, — नेटवर्क मॉडल में से इस भूमिका के लिए MiniMax M2.7 सबसे उपयुक्त है, और GLM-5.3 Flash को उसके अनिवार्य तर्क के साथ यहां न रखें। अनुवाद के लिए पहले दो में से कोई भी काम करेगा।

सत्यापन और निदान

प्रदाता पृष्ठ पर, कुंजी ब्लॉक में एक Model Check बटन होता है (V1 में — कुंजी फ़ील्ड के बगल में Check)। एक मॉडल चुनें — Cherry Studio उसे एक छोटा परीक्षण अनुरोध भेजेगा और परिणाम के साथ प्रतिक्रिया में लगने वाला समय (latency) दिखाएगा। यदि जाँच सफल रही, तो चैट पर जाएँ, मॉडल स्विच में गेटवे मॉडल चुनें और कोई भी प्रश्न पूछें।

यह सुनिश्चित करने के लिए कि अनुरोध गेटवे के माध्यम से जा रहे हैं, उसका डैशबोर्ड खोलें, "उपयोग" (Usage) अनुभाग: "कुंजियों द्वारा" ब्लॉक में Cherry Studio कुंजी के लिए अनुरोध और अंतिम उपयोग का समय दिखाई देगा, और "मॉडल द्वारा" ब्लॉक में चयनित मॉडल दिखाई देगा। V2 में क्लाइंट के अपने आँकड़े भी हैं, Usage सेटिंग्स अनुभाग: प्रदाताओं, मॉडलों और कुंजियों द्वारा टोकन और अनुरोध। वहाँ लागत केवल संदर्भ के लिए है — Cherry Studio इसका अनुमान मॉडल की सार्वजनिक कीमतों के आधार पर लगाता है, न कि Gonka नेटवर्क की कीमत के आधार पर, इसलिए सटीक राशि गेटवे डैशबोर्ड में देखें।

यदि कुछ गलत हो गया, तो कारण लगभग हमेशा उत्तर से पढ़ा जा सकता है:

क्या दिखाई देता है	इसका क्या अर्थ है	क्या करें
`401`, `Invalid API key`	गेटवे ने कुंजी को पहचाना नहीं	जाँचें कि कुंजी `jg-` से शुरू होती है, बिना किसी रिक्त स्थान के चिपकाई गई है, और "API-कुंजियाँ" अनुभाग में सक्रिय है
`404`, `Invalid URL (POST …)`	पथ में एक अतिरिक्त खंड है। एक विशिष्ट मामला — API Host में `#` के बिना पूरा पथ दर्ज है, और Cherry Studio ने `/chat/completions` दूसरी बार जोड़ दिया	फ़ील्ड में आधार पता `https://gate.joingonka.ai/v1` छोड़ें और Preview पंक्ति के साथ मिलान करें
`405 Not Allowed` या उत्तर के बजाय HTML	अनुरोध API से चूक गया: पता `#` पर समाप्त होता है, और इसमें `/v1` नहीं है	`#` हटा दें या `/v1` जोड़ें
`429`	मॉडल ओवरलोड है: पीक आवर्स के दौरान नेटवर्क में किसी विशिष्ट मॉडल की क्षमता पूरी तरह से उपयोग की जा सकती है	कुछ सेकंड बाद पुन: प्रयास करें या किसी अन्य मॉडल पर स्विच करें; नेटवर्क स्थिति स्थिति पृष्ठ पर देखी जा सकती है
जाँच सफल रही, लेकिन चैट में मॉडल नहीं है	प्रदाता बंद है या मॉडल उसकी सूची में नहीं जोड़ा गया है	प्रदाता को सक्षम करें और Sync models या Add Model के माध्यम से मॉडल जोड़ें
कुंजी दर्ज है, लेकिन चैट अभी भी जवाब नहीं दे रही है	असिस्टेंट किसी अन्य, सेट न किए गए प्रदाता के डिफ़ॉल्ट मॉडल पर काम कर रहा है	Default Model अनुभाग में गेटवे मॉडल सेट करें
GLM-5.3 Flash के लिए उत्तर खाली है या कट रहा है	असिस्टेंट सेटिंग्स में उत्तर की सीमा बहुत छोटी है: तर्क (reasoning) भी उसी सीमा में आता है	Max tokens सीमा हटा दें या इसे पर्याप्त रखें — 2000 टोकन से
मॉडल कहता है कि उसे चित्र दिखाई नहीं दे रहा	नेटवर्क मॉडल टेक्स्ट-आधारित हैं: गेटवे छवि को एक टेक्स्ट लेबल के साथ बदल देता है	मॉडल से Vision विकल्प हटा दें; छवियों वाले कार्यों के लिए ऐसे प्रदाता को सौंपें जिसके पास विज़न मॉडल हो — Cherry Studio में प्रदाता आराम से एक साथ रह सकते हैं

इसकी लागत कितनी है

क्लाइंट स्वयं मुफ्त में वितरित किया जाता है, आप केवल इन्फरेंस (inference) के लिए भुगतान करते हैं। JoinGonka Gateway के माध्यम से, टोकन इनपुट के लिए $0.0069 प्रति मिलियन और आउटपुट के लिए $0.021 प्रति मिलियन खर्च होते हैं — यह कीमत नेटवर्क के सभी मॉडलों के लिए समान है और इस पृष्ठ पर लाइव स्रोत से ली जाती है। चैट एजेंट टूल की तुलना में टोकन का उपयोग काफी कम करती है, इसलिए सितंबर 2026 के लिए कीमतों का अनुमान इस प्रकार है:

परिदृश्य	उपयोग	Gateway के माध्यम से
दर्जनों उत्तरों का संवाद	10-30 हजार टोकन	एक सेंट का सौवां हिस्सा
गहन कार्य का दिन: प्रश्न, अनुवाद, दस्तावेज़ विश्लेषण	0.5-1M टोकन	एक सेंट से कम
दैनिक उपयोग का महीना	15-30M टोकन	दर्जनों सेंट

लंबे संवादों के बारे में एक महत्वपूर्ण चेतावनी: हर उत्तर के साथ क्लाइंट मॉडल को पूरा इतिहास फिर से भेजता है, इसलिए सौवां उत्तर पहले वाले से महंगा होता है। उपाय — नए कार्य के लिए नया संवाद; Cherry Studio में यह सिर्फ एक बटन है।

विधि	आप भुगतान कैसे करते हैं	आपको क्या मिलता है
चैट सेवा की सदस्यता	प्रति माह एक निश्चित राशि	उसके इंटरफ़ेस में एक वेंडर के मॉडल, टैरिफ सीमा के साथ
Cherry Studio + वेंडर कुंजी	वेंडर की मूल्य सूची के अनुसार टोकन द्वारा	अपना इंटरफ़ेस और अपनी मशीन पर इतिहास; वॉल्यूम के साथ बिल बढ़ता है
Cherry Studio + JoinGonka Gateway	नेटवर्क मूल्य पर टोकन द्वारा, गेटवे बैलेंस से	एक ही कीमत पर ओपन नेटवर्क मॉडल, दिन, कुंजियों और मॉडलों के आधार पर उपयोग डैशबोर्ड में दिखाई देता है

यह कनेक्शन और क्या देता है

एक ही चैट में मॉडलों की तुलना। Cherry Studio एक साथ कई मॉडलों से एक ही प्रश्न पूछ सकता है: मॉडल स्विच में उन्हें चुनें, और प्रत्येक एक अलग अनुरोध के साथ उत्तर देगा। नेटवर्क के सभी मॉडलों के लिए एक ही कीमत पर, अपने कार्यों में यह समझने का यह सबसे तेज़ तरीका है कि MiniMax M2.7 कहाँ पर्याप्त है, कहाँ DeepSeek V4 Flash का लंबा उत्तर चाहिए, और कहाँ GLM-5.3 Flash की तर्क क्षमता (reasoning) काम आती है — इसकी सेटिंग्स मॉडल ओवरव्यू में दी गई हैं।

उसी कुंजी के साथ दूसरा प्रोटोकॉल। गेटवे Anthropic प्रारूप में भी प्रतिक्रिया देता है। V2 डायलॉग में इसके लिए Endpoint settings ब्लॉक में एक अलग Anthropic लाइन है: वहाँ https://gate.joingonka.ai लिखें, और Request path लाइन में /v1/messages पथ होना चाहिए। V1 में, Provider Type Anthropic और उसी पते के साथ एक अलग प्रदाता द्वारा यही परिणाम मिलता है। V2 में More options बटन के नीचे OpenAI Responses लाइन भी है — गेटवे इसे भी सपोर्ट करता है, पता मुख्य OpenAI लाइन जैसा ही है।

टर्मिनल एजेंटों को चलाना। Code CLI पेज (दस्तावेज़ीकरण में - Coding Companion) पर, Cherry Studio कंसोल एजेंटों को इंस्टॉल और रन करता है, जिसमें उसकी अपनी सेटिंग्स से प्रदाता और मॉडल का उपयोग किया जाता है; प्रदाताओं की सूची को उस प्रोटोकॉल द्वारा फ़िल्टर किया जाता है जिसकी विशिष्ट टूल को आवश्यकता होती है। इसलिए यदि आप यहाँ से Claude Code चलाने जा रहे हैं, तो Anthropic पता पहले ही भर लेना चाहिए। बिना मध्यस्थों के उसी एजेंट को कैसे सेट करें - Claude Code + Gonka गाइड में देखें।

ज्ञान आधार (Knowledge Base)। V2 में यह बिना एम्बेडिंग मॉडल के भी काम करता है — BM25 टेक्स्ट सर्च पर, और एम्बेडिंग मॉडल के साथ हाइब्रिड सर्च चालू हो जाता है। Gonka नेटवर्क के मॉडल जेनरेटिव हैं, इसलिए हाइब्रिड मोड के लिए किसी अन्य प्रदाता से एम्बेडिंग मॉडल लें, उदाहरण के लिए Ollama के माध्यम से स्थानीय रूप से; इस मामले में, पाए गए अंशों के आधार पर गेटवे का मॉडल उत्तर देगा।

क्या आपको ब्राउज़र में टीम के लिए एक साझा चैट चाहिए? Cherry Studio एक व्यक्तिगत डेस्कटॉप क्लाइंट है। खातों के साथ साझा वेब इंटरफ़ेस के लिए Open WebUI देखें: यह उसी पते और कुंजी के साथ गेटवे से जुड़ता है।

Cherry Studio, JoinGonka Gateway से अपने स्वयं के प्रदाता के रूप में जुड़ता है: Settings → Model Provider → Add Provider, पता https://gate.joingonka.ai/v1 और कुंजी jg-। /chat/completions पथ क्लाइंट स्वयं जोड़ता है और Preview लाइन में परिणाम दिखाता है; पते के अंत में # प्रतीक ऑटो-फिल को अक्षम कर देता है और गेटवे के लिए इसकी आवश्यकता नहीं है। इसके बाद — प्रदाता को सक्षम करें, Sync models के माध्यम से मॉडल जोड़ें, उनमें से Vision को अनचेक करें और Model Check बटन के साथ कनेक्शन की जांच करें। मुख्य मॉडल के रूप में DeepSeek V4 Flash, सहायक के रूप में MiniMax M2.7, और तर्क संबंधी कार्यों के लिए GLM-5.3 Flash का उपयोग करें; उपयोग की जांच गेटवे कैबिनेट के 'Usage' अनुभाग में की जा सकती है।

← Trae + JoinGonka Gateway — AI-IDE में Gonka नेटवर्क मॉडल omp (Oh My Pi) + JoinGonka Gateway: मॉडल भूमिकाओं वाला एजेंट →

अधिक जानना चाहते हैं?

अन्य अनुभागों का अन्वेषण करें या अभी GNK कमाना शुरू करें।

कुंजी और मुफ्त टोकन प्राप्त करें →