ब्लॉग पर वापस जाएं

टूल्स और इंटीग्रेशनगाइड

Cherry Studio को CheapTokens से कनेक्ट करें: कस्टम प्रोवाइडर, Base URL

Cherry Studio में कस्टम प्रोवाइडर जोड़ें: अंत में स्लैश वाला Base URL, API key, मॉडल id और Model Check, साथ ही 401 और 404 के समाधान।

CheapTokens Team द्वाराप्रकाशित 10 मिनट का पाठ

Cherry Studio CheapTokens से जुड़ा हुआ: प्रोवाइडर जोड़ें, API key, DeepSeek-V4-Flash
इस पृष्ठ पर
  1. ऐप खोलने से पहले आपको क्या चाहिए
  2. कस्टम प्रोवाइडर जोड़ें
  3. अंत में स्लैश क्यों मायने रखता है
  4. Key, मॉडल और Model Check
  5. पहला संदेश भेजें
  6. डेस्कटॉप चैट में कौन सा मॉडल डालें
  7. एक चैट सत्र का खर्च
  8. अगर यह काम न करे

Cherry Studio में CheapTokens का उपयोग करने के लिए, एक कस्टम प्रोवाइडर जोड़ें (Settings → Model Provider → Add Provider), OpenAI Base URL फ़ील्ड में https://api.cheaptokens.dev/v1/ डालें, अपनी API key पेस्ट करें और मॉडल id deepseek-ai/DeepSeek-V4-Flash-0731 को हाथ से जोड़ें। फिर Model Check से key जाँचें और हैलो कहें। बस इतना ही काम है; एकमात्र बारीकी जो परेशान करती है वह है URL के अंत में मौजूद स्लैश।

आप डेस्कटॉप चैट ऐप इसलिए खोलते हैं क्योंकि आप कई मॉडलों के लिए एक विंडो और उनके पीछे एक बैलेंस चाहते हैं, न कि हर सेवा के लिए एक ब्राउज़र टैब। Cherry Studio इसी के लिए बना है: यह Windows, macOS और Linux (AGPL-3.0 Community Edition) के लिए एक ओपन-सोर्स AI वर्कस्टेशन है जिसमें चैट, एजेंट और नॉलेज बेस हैं, और यह किसी भी OpenAI-संगत सेवा को कस्टम प्रोवाइडर के रूप में स्वीकार करता है। CheapTokens OpenAI Chat Completions फ़ॉर्मेट बोलता है, इसलिए यह फ़िट बैठता है। नीचे दिए गए चरण Cherry Studio के कस्टम प्रोवाइडर वाले डॉक्स पेज का अनुसरण करते हैं, जिन्हें 7 नवंबर 2026 को जाँचा गया; ऐप स्वयं बदलता रहता है, इसलिए अगर कोई लेबल हट गया हो, तो आस-पास उसी शब्द को खोजें।

ऐप खोलने से पहले आपको क्या चाहिए#

तीन चीज़ें, सभी छोटी:

  • Base URL: https://api.cheaptokens.dev/v1/ (अंत में स्लैश के साथ — कारण अगले सेक्शन में है);
  • अपने CheapTokens खाते से एक API key, जिसे आप कहीं से कॉपी कर सकें, किसी साझा नोट में पेस्ट न किया गया हो;
  • पूरा मॉडल id। प्राइस लिस्ट वाला छोटा नाम API स्वीकार नहीं करता; गेटवे id का उपयोग करें, उदाहरण के लिए deepseek-ai/DeepSeek-V4-Flash-0731। बाकी id list-models गाइड और CheapTokens डॉक्स में हैं।

कस्टम प्रोवाइडर जोड़ें#

Settings (गियर आइकन) खोलें, फिर Model Provider। प्रोवाइडर सूची के नीचे + Add Provider है। उस पर क्लिक करें और Add Custom Provider डायलॉग दिखाई देगा।

इसे इस तरह भरें:

फ़ील्ड क्या दर्ज करें
Provider Name CheapTokens (कोई भी नाम जिसे आप पहचान सकें)
API Key आपकी CheapTokens key
OpenAI Base URL https://api.cheaptokens.dev/v1/

Cherry Studio डिफ़ॉल्ट रूप से 'OpenAI' और 'Anthropic' एंडपॉइंट फ़ील्ड दिखाता है। केवल वही प्रोटोकॉल भरें जो आप वास्तव में उपयोग करते हैं; सामान्य चैट के लिए वह OpenAI वाला है, और Anthropic फ़ील्ड खाली रह सकता है। प्रत्येक Base URL फ़ील्ड के नीचे ऐप अंतिम रिक्वेस्ट पाथ का प्रीव्यू दिखाता है। उसे पढ़ें। कुछ भी भेजने से पहले गलत पता पकड़ने का यह सबसे तेज़ तरीका है।

The values for the Add Custom Provider dialog
Values to enter in Cherry Studio's Add Custom Provider dialog: name, key, OpenAI Base URL and model id

सहेजने के लिए Add पर क्लिक करें।

अंत में स्लैश क्यों मायने रखता है#

Cherry Studio अपने डॉक्स (7 नवंबर 2026 को जाँचा गया) में तीन नियमों से आपके Base URL से रिक्वेस्ट URL बनाता है:

  • https://example.com जैसे रूट पते में /v1/chat/completions जोड़ा जाता है;
  • / पर समाप्त होने वाले पते में केवल chat/completions जोड़ा जाता है;
  • # पर समाप्त होने वाले पते का ठीक वैसे ही उपयोग किया जाता है जैसे टाइप किया गया हो, कुछ भी नहीं जोड़ा जाता।

CheapTokens /v1 के अंतर्गत आता है, इसलिए https://api.cheaptokens.dev/v1/ वह रूप है जो https://api.cheaptokens.dev/v1/chat/completions में बदलता है — वही पाथ जिसकी API अपेक्षा करता है। फ़ील्ड के नीचे प्रीव्यू में ठीक यही दिखना चाहिए। अगर आपको /v1/v1/ दिखे या /v1 बिल्कुल न हो, तो आगे बढ़ने से पहले फ़ील्ड ठीक करें।

Two Base URL endings and the path each one produces
How Cherry Studio completes the Base URL: a trailing slash adds chat/completions, a trailing # is used as-is

Key, मॉडल और Model Check#

प्रोवाइडर के पेज पर वापस पाँच छोटे चरण हैं। इन्हें इसी क्रम में करें:

क्रम में लगाएँ

Connect the provider in this order

  1. प्रोवाइडर का enable स्विच चालू करें (उसके पेज के ऊपर दाईं ओर)
  2. API key दर्ज करें
  3. key सत्यापित करने के लिए Model Check पर क्लिक करें
  4. Base URL जाँचें
  5. मॉडल प्रबंधन में + बटन से मॉडल id जोड़ें

चरण 5 पर एक नोट। पेज पर एक Sync models बटन भी है जो सेवा से मॉडल सूची लाता है। भरोसेमंद तरीका यह है कि आप + से स्वयं id जोड़ें: deepseek-ai/DeepSeek-V4-Flash-0731 को deepseek-ai/ भाग के साथ ठीक वैसे ही टाइप करें। आप कौन से मॉडल जोड़ सकते हैं:

मॉडल टाइप करने के लिए मॉडल id कॉन्टेक्स्ट अधिकतम उत्तर
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731 380K 32,768 tokens
GLM-5.3-Flash zai-org/GLM-5.3-Flash 390K 8,192 tokens
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 180K 8,192 tokens

Model Check key फ़ील्ड के बगल वाला बटन है; Cherry Studio डॉक्स के अनुसार, यह जाँचता है कि key मान्य है। अगर यह शिकायत करे, तो नीचे त्रुटि वाले सेक्शन पर जाएँ: कारण आमतौर पर तीन फ़ील्ड में से एक होता है।

पहला संदेश भेजें#

एक नई चैट खोलें, ऊपर मॉडल सेलेक्टर में CheapTokens प्रोवाइडर और आपके द्वारा जोड़ा गया मॉडल चुनें, और कुछ छोटा लिखें, जैसे 'Explain what a token is in two sentences.' मॉडल से उत्तर आना इस बात का मतलब है कि पूरी श्रृंखला काम कर रही है: key, पता, मॉडल id।

ऐप के बिना कोई रिक्वेस्ट देखना चाहते हैं? यहाँ एक सादा Chat Completions कॉल है:

bash
export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

उत्तर JSON है जिसमें टेक्स्ट choices[0].message.content में और token गणनाएँ usage में हैं।

डेस्कटॉप चैट में कौन सा मॉडल डालें#

चैट विंडो एजेंट लूप से अलग काम है: आप पूछते हैं, पढ़ते हैं, फिर पूछते हैं। तब दो बातें मायने रखती हैं: उत्तर कितने लंबे हो सकते हैं और कितनी बड़ी बातचीत फ़िट होती है।

  • DeepSeek-V4-Flash — सामान्य चैट और लंबे दस्तावेज़ों के लिए डिफ़ॉल्ट पसंद: प्रति उत्तर 32,768 आउटपुट tokens तक, 380K कॉन्टेक्स्ट, किसी भी समय एक ही कीमत। कुल मिलाकर, इनपुट और आउटपुट को साथ गिनने पर, यह OpenRouter से सस्ता है।
  • GLM-5.3-Flash — तीनों में सबसे बड़ी विंडो (390K) के साथ रोज़मर्रा की चैट, इनपुट और आउटपुट दोनों पर OpenRouter से सस्ता।
  • MiniMax-M2.7 — 180K कॉन्टेक्स्ट के साथ चैट और एजेंट-शैली के कार्य, दोनों ओर से OpenRouter से सस्ता।

तीनों एक ही बैलेंस के पीछे हैं, इसलिए आप तीनों id एक ही प्रोवाइडर में जोड़ सकते हैं और key को छुए बिना मॉडल सेलेक्टर में स्विच कर सकते हैं।

एक चैट सत्र का खर्च#

यहाँ एक मोटा अनुमान है। मान लें आपकी 20-संदेशों की बातचीत है। हर संदेश पिछला इतिहास फिर से भेजता है, इसलिए एक रिक्वेस्ट में औसतन लगभग 6,000 tokens इन और 500 tokens आउट होते हैं (इसका कारण लंबी चैट अधिक महँगी क्यों होती है में बताया गया है)। DeepSeek-V4-Flash पर एक रिक्वेस्ट का खर्च $0.00014 है। इनमें से बीस नीचे कैलकुलेटर में हैं; अपनी चैट के अनुसार स्लाइडर घुमाएँ।

लागत कैलकुलेटर

One 20-message chat session

प्रति अनुरोध इनपुट टोकन: 6,000 · प्रति अनुरोध आउटपुट टोकन: 500 · प्रति दिन अनुरोध: 20

मॉडलप्रति दिनप्रति माह
GLM-5.3-Flash$0.0028$0.084
DeepSeek-V4-Flash$0.0028$0.084
MiniMax-M2.7$0.0075$0.225

नीचे दी गई तालिका वही सत्र सभी मॉडलों पर चलाती है, तुलना के लिए एक OpenRouter कॉलम के साथ:

मॉडल प्रति अनुरोध 20 अनुरोध OpenRouter, 20 अनुरोध
GLM-5.3-Flash $0.00014 $0.0028 $0.0049
DeepSeek-V4-Flash $0.00014 $0.0028 $0.0098
MiniMax-M2.7 $0.00038 $0.0075 $0.09

प्रति अनुरोध 6,000 इनपुट और 500 आउटपुट टोकन। प्रति 1M टोकन की कीमतें वर्तमान हैं और हमारे टैरिफ के साथ बदलती रहती हैं; OpenRouter कॉलम समान कार्यभार के लिए संदर्भ कीमतें दिखाता है।

प्रति 1M tokens की वर्तमान कीमतों के लिए CheapTokens मूल्य निर्धारण देखें।

अगर यह काम न करे#

अधिकांश समस्याएँ उन्हीं तीन फ़ील्ड से आती हैं: key, URL, मॉडल id। जो आप देखते हैं उसे कारण से मिलाएँ:

जोड़े मिलाएँ

Match the symptom to the likely cause

  • 401 UnauthorizedAPI key गायब है, गलत टाइप की गई है या उसमें अतिरिक्त स्पेस है
  • 404 Not FoundBase URL गलत है: पाथ प्रीव्यू /v1/chat/completions पर समाप्त नहीं होता
  • ऐप अज्ञात मॉडल बताता हैसंभवतः मॉडल id छोटा नाम है; प्रीफ़िक्स के साथ पूरा id टाइप करें
  • ऐप अपर्याप्त बैलेंस बताता हैसंभवतः बैलेंस खाली है और टॉप-अप की ज़रूरत है

इन त्रुटियों के अधिक विस्तृत विवरण के लिए, API 401 या 404: गलत key, base URL या मॉडल id देखें। और अगर आप डेस्कटॉप ऐप के बजाय ब्राउज़र-आधारित चैट पसंद करते हैं, तो Open WebUI भी इसी तरह काम करता है।

स्रोत: Cherry Studio डॉक्स, कस्टम प्रोवाइडर और प्रोवाइडर सेटिंग्स पेज, 7 नवंबर 2026 को जाँचा गया; प्रोजेक्ट github.com/CherryHQ/cherry-studio पर है।