কীভাবে OpenCode-কে CheapTokens-এর সাথে সংযুক্ত করবেন (opencode.json)

OpenCode-কে CheapTokens-এর সাথে সংযুক্ত করতে, একটি কাস্টম OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার যোগ করুন: /connect দিয়ে আপনার API কী সংরক্ষণ করুন (প্রোভাইডার আইডি cheaptokens), তারপর opencode.json-এ বেস URL https://api.cheaptokens.dev/v1 সহ প্রোভাইডারটি বর্ণনা করুন। এরপর আপনার CheapTokens মডেলগুলি /models-এ দেখা যাবে।

এই গাইডটি OpenCode-এর প্রোভাইডার ডকুমেন্টেশন অনুসরণ করে (পৃষ্ঠাটি ২০ অক্টোবর, ২০২৬-এ আপডেট করা হয়েছে; ২২ অক্টোবর, ২০২৬-এ যাচাই করা হয়েছে)। এই সিরিজের অন্যান্য টুলের জন্যও একই পদ্ধতি কাজ করে: Cline, Aider এবং Kilo Code।

আপনার যা প্রয়োজন#

• OpenCode ইনস্টল করা (আপনার প্ল্যাটফর্মের জন্য এর ডকুমেন্টেশন দেখুন)।
• একটি CheapTokens API কী। আপনার অ্যাকাউন্টে একটি তৈরি করুন এবং ব্যালেন্স টপ আপ করুন; একটি ব্যালেন্সই সব মডেলের জন্য যথেষ্ট। মূল বিষয়গুলি CheapTokens ডক্স-এ রয়েছে।
• API-এর তথ্য:
  • বেস URL: https://api.cheaptokens.dev/v1
  • সামঞ্জস্য: OpenAI Chat Completions এবং Anthropic Messages
  • নিচে ব্যবহৃত মডেল আইডি: deepseek-ai/DeepSeek-V4-Flash-0731 (380K কনটেক্সট, সর্বোচ্চ 32,768 আউটপুট টোকেন)। মডেল আইডিগুলি CheapTokens ডক্সে তালিকাভুক্ত করা আছে: প্রোভাইডারভেদে নাম ভিন্ন হয়, তাই সেখান থেকে আইডি কপি করুন।

ধাপ ১. /connect দিয়ে কী সংরক্ষণ করুন#

1. আপনার প্রজেক্টে OpenCode চালু করুন এবং /connect চালান।
2. Other-এ স্ক্রল করুন।
3. একটি অনন্য প্রোভাইডার আইডি লিখুন: cheaptokens।
4. আপনার CheapTokens API কী পেস্ট করুন।

এই ধাপটি শুধুমাত্র ক্রেডেনশিয়াল সংরক্ষণ করে। OpenCode এখনও প্রোভাইডারের ঠিকানা বা মডেলগুলি জানে না: সেটিই opencode.json-এর কাজ।

ধাপ ২. opencode.json-এ প্রোভাইডার বর্ণনা করুন#

opencode.json তৈরি করুন বা সম্পাদনা করুন এবং প্রোভাইডার যোগ করুন। provider-এ প্রোভাইডার আইডি অবশ্যই /connect-এ আপনার দেওয়া আইডির সাথে মিলতে হবে।

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

প্রতিটি অংশ কী করে:

• npm — @ai-sdk/openai-compatible হল সেইসব এন্ডপয়েন্টের জন্য প্যাকেজ যেগুলি /v1/chat/completions ব্যবহার করে, যা CheapTokens প্রকাশ করে। (OpenCode /v1/responses-এর উপর নির্মিত এন্ডপয়েন্টের জন্য @ai-sdk/openai ব্যবহার করে।)
• name — OpenCode ইন্টারফেসে দেখানো লেবেল।
• options.baseURL — CheapTokens API ঠিকানা।
• models — মডেল আইডি দ্বারা কী করা; ভিতরের name একটি ডিসপ্লে নাম।
• limit.context / limit.output — ঐচ্ছিক; এগুলি OpenCode-কে মডেলের কনটেক্সট উইন্ডো এবং সর্বোচ্চ উত্তরের দৈর্ঘ্য জানায়।

পরিবর্তে কীটি একটি এনভায়রনমেন্ট ভেরিয়েবলে রাখুন (ঐচ্ছিক)#

যদি আপনি OpenCode-এর ক্রেডেনশিয়াল স্টোরে কীটি না রাখতে চান, তাহলে ডক্সে সুপারিশ করা {env:VARIABLE} সিনট্যাক্স দিয়ে options-এ apiKey যোগ করুন:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

তারপর আপনার শেলে CHEAPTOKENS_API_KEY এক্সপোর্ট করুন। রিপোজিটরিতে একটি আসল কী কমিট করবেন না। আপনি যদি কী-তে নতুন হন, তাহলে একটি API কী কী এবং কীভাবে নিরাপদে সংরক্ষণ করবেন পড়ুন।

ধাপ ৩. এটি কাজ করছে কিনা পরীক্ষা করুন#

/models চালান এবং CheapTokens প্রোভাইডারের অধীনে DeepSeek-V4-Flash বেছে নিন। তারপর একটি ছোট প্রম্পট পাঠান, উদাহরণস্বরূপ: "Summarize what this repository does in three sentences." একটি স্বাভাবিক উত্তর মানে বেস URL, কী এবং মডেল আইডি সবই সঠিক।

কোন CheapTokens মডেল বেছে নেবেন#

models-এ আপনি যত খুশি এন্ট্রি যোগ করুন — প্রতিটি উপরের মতো একটি ব্লক, নিজস্ব আইডি সহ।

একটি OpenCode সেশনের জন্য, যা লুপে অনেক অনুরোধ পাঠায়, DeepSeek-V4-Flash একটি ভালো ডিফল্ট: আউটপুট OpenRouter-এর রেফারেন্স দামের চেয়ে সস্তা, উত্তর 32,768 টোকেন পর্যন্ত পৌঁছাতে পারে, এবং দামে কোনো পিক আওয়ার নেই। MiniMax-M2.7-ও ইনপুট এবং আউটপুট উভয় ক্ষেত্রেই OpenRouter-এর রেফারেন্স দামের চেয়ে সস্তা। GLM-5.3-Flash-এর আউটপুটও OpenRouter-এর রেফারেন্স দামের চেয়ে সস্তা। বর্তমান দাম (লাইভ যাচাই করা, পুরনো হয়ে যাওয়ার মতো কোনো সংখ্যা নেই):

একটি কার্যকরী সেশন অনুমান করতে, উদাহরণস্বরূপ প্রতিটিতে 100,000 ইনপুট এবং 5,000 আউটপুট টোকেন সহ 20টি অনুরোধ:

আরও জানতে সব দাম এবং DeepSeek পৃষ্ঠা দেখুন।

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

• /models-এ প্রোভাইডার বা মডেলগুলি অনুপস্থিত। পরীক্ষা করুন যে opencode.json বৈধ JSON (কোনো ট্রেইলিং কমা নেই) এবং provider-এর অধীনে কীটি ঠিক /connect-এ আপনার দেওয়া আইডি। যদি দুটোই সঠিক হয়, OpenCode পুনরায় চালু করুন।
• 401 / প্রমাণীকরণ ত্রুটি। /connect আবার চালান এবং কীটি আবার পেস্ট করুন, অথবা যে শেলে OpenCode শুরু হয় সেখানে CHEAPTOKENS_API_KEY ভেরিয়েবল পরীক্ষা করুন।
• 404 বা "model not found"। models-এ মডেল আইডি অবশ্যই অক্ষরে অক্ষরে CheapTokens আইডির সাথে মিলতে হবে, ভেন্ডর প্রিফিক্স (deepseek-ai/…) সহ।
• সংযোগ ত্রুটি। বেস URL অবশ্যই /v1 দিয়ে শেষ হতে হবে এবং কোনো অতিরিক্ত পাথ থাকা যাবে না। সাধারণ সংযোগ ত্রুটি দেখুন।
• "Not enough tokens"। ব্যালেন্স টপ আপ করুন; ত্রুটির অর্থ কী দেখুন।

পরবর্তী ধাপ#

এখন আপনার OpenCode সব মডেলের জন্য একটি ব্যালেন্স সহ CheapTokens-এ চলছে। একটি কী নিন এবং CheapTokens ডক্স থেকে আপনার প্রথম কল করুন।