ব্লগে ফিরে যান

টুল ও ইন্টিগ্রেশনগাইড

Cherry Studio-কে CheapTokens-এর সাথে সংযুক্ত করুন: কাস্টম প্রোভাইডার, Base URL

Cherry Studio-তে একটি কাস্টম প্রোভাইডার যোগ করুন: শেষে স্ল্যাশ সহ Base URL, API key, মডেল আইডি এবং 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 পেস্ট করুন এবং ম্যানুয়ালি মডেল আইডি deepseek-ai/DeepSeek-V4-Flash-0731 যোগ করুন। তারপর Model Check দিয়ে key যাচাই করুন এবং hello বলুন। এটাই পুরো কাজ; একমাত্র যে বিষয়টি সমস্যা করে তা হল URL-এর শেষে স্ল্যাশ।

আপনি একটি ডেস্কটপ চ্যাট অ্যাপ খোলেন কারণ আপনি একাধিক মডেলের জন্য একটি উইন্ডো এবং তাদের পেছনে একটি ব্যালেন্স চান, প্রতি সার্ভিসের জন্য একটি ব্রাউজার ট্যাব নয়। Cherry Studio এটির জন্যই তৈরি: এটি Windows, macOS এবং Linux-এর জন্য একটি ওপেন-সোর্স AI ওয়ার্কস্টেশন (AGPL-3.0 Community Edition) যাতে চ্যাট, এজেন্ট এবং নলেজ বেস রয়েছে, এবং এটি যেকোনো OpenAI-সামঞ্জস্যপূর্ণ সার্ভিসকে কাস্টম প্রোভাইডার হিসেবে গ্রহণ করে। CheapTokens OpenAI Chat Completions ফরম্যাটে কথা বলে, তাই এটি মানানসই। নিচের ধাপগুলি Cherry Studio ডক্সের কাস্টম প্রোভাইডার পৃষ্ঠা অনুসরণ করে, ৭ নভেম্বর ২০২৬-এ যাচাই করা; অ্যাপটি নিজেই পরিবর্তিত হয়, তাই যদি কোনো লেবেল সরে যায়, কাছাকাছি একই শব্দ খুঁজুন।

অ্যাপ খোলার আগে আপনার যা প্রয়োজন#

তিনটি জিনিস, সবই সংক্ষিপ্ত:

  • Base URL: https://api.cheaptokens.dev/v1/ (শেষে স্ল্যাশ সহ — কারণ পরের বিভাগে);
  • আপনার CheapTokens অ্যাকাউন্ট থেকে একটি API key, এমন জায়গায় রাখুন যেখান থেকে কপি করতে পারেন, শেয়ার করা নোটে পেস্ট করবেন না;
  • সম্পূর্ণ মডেল আইডি। প্রাইস লিস্টের সংক্ষিপ্ত নাম API গ্রহণ করে না; গেটওয়ে আইডি ব্যবহার করুন, উদাহরণস্বরূপ deepseek-ai/DeepSeek-V4-Flash-0731। অন্যান্য আইডি 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 তার ডক্সে (৭ নভেম্বর ২০২৬-এ যাচাই করা) তিনটি নিয়মে আপনার 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#

প্রোভাইডারের পৃষ্ঠায় ফিরে পাঁচটি ছোট ধাপ আছে। এই ক্রমে সেগুলি করুন:

ক্রমে সাজান

এই ক্রমে প্রোভাইডার সংযুক্ত করুন

  1. প্রোভাইডারের এনাবল সুইচ চালু করুন (এর পৃষ্ঠার উপরে ডানদিকে)
  2. API key লিখুন
  3. key যাচাই করতে Model Check ক্লিক করুন
  4. Base URL পরীক্ষা করুন
  5. মডেল ম্যানেজমেন্টে + বোতাম দিয়ে মডেল আইডি যোগ করুন

ধাপ ৫ সম্পর্কে একটি নোট। পৃষ্ঠায় একটি Sync models বোতামও আছে যা সার্ভিস থেকে একটি মডেল তালিকা আনে। নির্ভরযোগ্য উপায় হল + দিয়ে নিজে আইডি যোগ করা: deepseek-ai/DeepSeek-V4-Flash-0731 ঠিক টাইপ করুন, deepseek-ai/ অংশ সহ। কোন মডেলগুলি যোগ করতে পারেন:

মডেল যে মডেল আইডি টাইপ করবেন কনটেক্সট সর্বোচ্চ উত্তর
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731 380K 32,768 টোকেন
GLM-5.3-Flash zai-org/GLM-5.3-Flash 390K 8,192 টোকেন
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 180K 8,192 টোকেন

Model Check হল key ফিল্ডের পাশের বোতাম; Cherry Studio ডক্স অনুসারে, এটি যাচাই করে যে key বৈধ। যদি এটি অভিযোগ করে, নিচের ত্রুটি বিভাগে যান: কারণ সাধারণত তিনটি ফিল্ডের একটি।

প্রথম বার্তা পাঠান#

একটি নতুন চ্যাট খুলুন, উপরে মডেল সিলেক্টরে CheapTokens প্রোভাইডার এবং আপনি যে মডেল যোগ করেছেন তা বেছে নিন, এবং সংক্ষিপ্ত কিছু লিখুন, যেমন 'Explain what a token is in two sentences.' মডেল থেকে একটি উত্তর মানে পুরো চেইন কাজ করে: key, ঠিকানা, মডেল আইডি।

অ্যাপ ছাড়াই একটি রিকোয়েস্ট দেখতে চান? এখানে একটি সাধারণ 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-এ এবং টোকেন গণনা usage-এ।

ডেস্কটপ চ্যাটে কোন মডেল রাখবেন#

একটি চ্যাট উইন্ডো এজেন্ট লুপ থেকে ভিন্ন কাজ: আপনি জিজ্ঞাসা করেন, পড়েন, আবার জিজ্ঞাসা করেন। তখন দুটি বিষয় গুরুত্বপূর্ণ: উত্তর কত দীর্ঘ হতে পারে এবং কত বড় কথোপকথন ফিট হয়।

  • DeepSeek-V4-Flash — সাধারণ চ্যাট এবং দীর্ঘ নথির জন্য ডিফল্ট পছন্দ: প্রতি উত্তরে 32,768 আউটপুট টোকেন পর্যন্ত, 380K কনটেক্সট, যেকোনো সময় একই দাম। মোট, ইনপুট এবং আউটপুট একসাথে গণনা করলে, এটি OpenRouter-এর চেয়ে সস্তা।
  • GLM-5.3-Flash — দৈনন্দিন চ্যাট, তিনটির মধ্যে সবচেয়ে বড় উইন্ডো (390K), ইনপুট এবং আউটপুট উভয়েই OpenRouter-এর চেয়ে সস্তা।
  • MiniMax-M2.7 — 180K কনটেক্সট সহ চ্যাট এবং এজেন্ট-স্টাইল কাজ, উভয় দিকেই OpenRouter-এর চেয়ে সস্তা।

তিনটিই একটি ব্যালেন্সের পেছনে, তাই আপনি একই প্রোভাইডারে তিনটি আইডি যোগ করতে পারেন এবং key স্পর্শ না করেই মডেল সিলেক্টরে সুইচ করতে পারেন।

একটি চ্যাট সেশনের খরচ#

এখানে একটি মোটামুটি চিত্র। ধরুন আপনার একটি ২০-বার্তার কথোপকথন আছে। প্রতিটি বার্তা আগের ইতিহাস পুনরায় পাঠায়, তাই একটি রিকোয়েস্টে গড়ে প্রায় 6,000 টোকেন ইন এবং 500 টোকেন আউট (দীর্ঘ চ্যাট কেন বেশি খরচ করে-তে একটি কারণ কভার করা হয়েছে)। DeepSeek-V4-Flash-এ একটি রিকোয়েস্টের খরচ $0.00014। এরকম বিশটি নিচের ক্যালকুলেটরে আছে; আপনার নিজের চ্যাটের সাথে মেলাতে স্লাইডার সরান।

খরচ ক্যালকুলেটর

একটি ২০-বার্তার চ্যাট সেশন

প্রতি অনুরোধে ইনপুট টোকেন: ৬,০০০ · প্রতি অনুরোধে আউটপুট টোকেন: ৫০০ · প্রতিদিন অনুরোধ: ২০

মডেলপ্রতিদিনপ্রতি মাসে
GLM-5.3-Flash$0.0028$0.084
DeepSeek-V4-Flash$0.0028$0.084
MiniMax-M2.7$0.0075$0.225

নিচের টেবিলটি সমস্ত মডেলে একই সেশন চালায়, তুলনার জন্য একটি OpenRouter কলাম সহ:

মডেল প্রতি অনুরোধে ২০টি অনুরোধ OpenRouter, ২০টি অনুরোধ
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

প্রতি অনুরোধে ৬,০০০ ইনপুট এবং ৫০০ আউটপুট টোকেন। প্রতি 1M টোকেনের দাম বর্তমান এবং আমাদের ট্যারিফের সাথে পরিবর্তিত হয়; OpenRouter কলামটি একই ওয়ার্কলোডের জন্য রেফারেন্স মূল্য দেখায়।

প্রতি 1M টোকেনের বর্তমান দামের জন্য CheapTokens প্রাইসিং দেখুন।

যদি এটি কাজ না করে#

বেশিরভাগ সমস্যা একই তিনটি ফিল্ড থেকে আসে: key, URL, মডেল আইডি। আপনি যা দেখেন তা কারণের সাথে মেলান:

জোড়া মেলান

লক্ষণের সাথে সম্ভাব্য কারণ মেলান

  • 401 UnauthorizedAPI key অনুপস্থিত, ভুল টাইপ করা বা অতিরিক্ত স্পেস আছে
  • 404 Not FoundBase URL ভুল: পাথ প্রিভিউ /v1/chat/completions-এ শেষ হয় না
  • অ্যাপ একটি অজানা মডেল রিপোর্ট করেসম্ভবত মডেল আইডি সংক্ষিপ্ত নাম; প্রিফিক্স সহ সম্পূর্ণ আইডি টাইপ করুন
  • অ্যাপ অপর্যাপ্ত ব্যালেন্স রিপোর্ট করেসম্ভবত ব্যালেন্স খালি এবং টপ-আপ প্রয়োজন

এই ত্রুটিগুলির আরও বিস্তারিত ওয়াকথ্রুর জন্য, API 401 বা 404: ভুল key, base URL বা মডেল আইডি দেখুন। এবং যদি আপনি ডেস্কটপ অ্যাপের পরিবর্তে ব্রাউজার-ভিত্তিক চ্যাট পছন্দ করেন, Open WebUI একইভাবে কাজ করে।

সূত্র: Cherry Studio ডক্স, কাস্টম প্রোভাইডার এবং প্রোভাইডার সেটিংস পৃষ্ঠা, ৭ নভেম্বর ২০২৬-এ যাচাই করা; প্রকল্পটি github.com/CherryHQ/cherry-studio-এ।