Plan, credit আর Wallet

Tokens-এ usage-এর টাকা দেওয়ার দুটো উপায় আছে: credit-এর allowance সহ subscription plan, আর pay-as-you-go-এর জন্য আগে থেকে টাকা ভরে রাখা Wallet। এই পেজে বুঝিয়ে বলা হয়েছে plan, credit আর Wallet কীভাবে একসাথে কাজ করে, আর কিছু শেষ হয়ে গেলে ঠিক কী ঘটে। এখনকার plan আর দাম দেখতে যান pricing পেজে।

Subscription plan বনাম pay-as-you-go Wallet#

দুটোই একসাথে রাখতে পারেন। Plan থাকলে usage-এর খরচ আগে plan-এর credit থেকে কাটে।

Credit কীভাবে কাজ করে#

Plan-এর allowance মাপা হয় credit দিয়ে। ডিফল্টে 100 credit = 1 USD। হারটা plan ভেদে আলাদা হতে পারে, plan-এর পেজেই সেটা দেখানো থাকে। প্রতিটা request-এর খরচ ধরা হয় model-এর catalog price অনুযায়ী, যত token লেগেছে তার হিসাবে (input, output আর cache-read token)। response শেষ হলে সেই খরচ আপনার credit থেকে কেটে নেওয়া হয়। প্রতিটা model-এর দাম দেখুন /models পেজে।

Plan-এর credit যে billing period-এর জন্য কেনা, সেই period-এরই থাকে।

Model-ভিত্তিক allowance, ফ্রি model আর deal#

কিছু plan-এ নির্দিষ্ট model-এর জন্য আলাদা allowance থাকে, কিছু model ফ্রি থাকে, আবার কোনো model-এ deal চলে। কোন plan-এ কী আছে তা pricing-এ plan-এর পেজে লেখা থাকে, যেমন "$10 on DeepSeek V4.1 Flash" বা "Free on Ling 3.1 Flash"।

• Allowance মানে plan-এর usage-এর ভেতরের একটা সীমা, বাড়তি কিছু নয়। কোনো model চালালে খরচ একসাথে plan-এর credit থেকে আর ওই model-এর allowance থেকে কাটে। ধরুন plan-এ $10 usage আছে আর DeepSeek V4.1 Flash-এ $10 allowance আছে। DeepSeek-এ $5 খরচ করলে DeepSeek-এর allowance বাকি থাকে $5, আর সব model-এর জন্য plan usage বাকি থাকে $5। এরপর বাকি $5 অন্য model-এ খরচ করে ফেললে plan খালি হয়ে যায়, তখন DeepSeek-ও বন্ধ, যদিও তার নিজের allowance-এ তখনো $5 দেখাচ্ছে।
• যে model-এর allowance নেই, সেটা শুধু plan-এর credit থেকে চলে, model catalog-এর দামে।
• ফ্রি model-এ কোনো খরচ নেই। এটা আপনার credit বা কোনো allowance থেকে কাটে না, আর plan-এর credit শেষ হয়ে গেলেও চলতে থাকে।
• Deal থাকলে ওই model-এর দাম কমে যায়, ফলে একই credit-এ বেশি কাজ হয়। Wallet-এর টাকায় কখনো ছাড় মেলে না: কোনো request-এর টাকা Wallet থেকে গেলে পুরো catalog price-ই লাগে।
• Allowance reset হয় billing period-এর সাথে, মানে যেদিন plan-এর credit reset হয় সেদিনই। Dashboard-এর Usage পেজে দেখা যায় প্রতিটা allowance-এর কতটা খরচ হয়েছে আর কবে reset হবে। কোনো model-এর allowance 80% আর 100% হলে ইমেইলও পাবেন।

কোনো model-এর allowance শেষ হয়ে গেলে reset পর্যন্ত ওই model-এর request-এ 429 model_limit_reached আসবে। আপনার বাকি model-গুলো চলবে। যে plan-এ pay-as-you-go fallback আছে, সেখানে ওই model-এর request-এর টাকা পুরো দামে Wallet থেকে কাটবে।

{
  "error": {
    "message": "You've used your $10.00 allowance for DeepSeek V4.1 Flash this billing period. It resets on 4 Nov 2026. Other models on your plan still work. See your plan: https://tokens.bd/dashboard/billing",
    "type": "rate_limit_error",
    "code": "model_limit_reached"
  }
}

Usage window: 5-hour, weekly আর monthly#

কিছু plan-এ allowance সময়ের ওপর ছড়িয়ে দেওয়া হয় usage window দিয়ে, যাতে এক দিনের ভারী ব্যবহারে পুরো মাসের credit উড়ে না যায়। একটা plan-এ এগুলোর যেকোনোটা থাকতে পারে:

Plan অনুযায়ী window মাপা হয় credit দিয়ে, নয়তো request-এর সংখ্যা দিয়ে। প্রতিটা window কতটা খরচ হয়েছে আর কখন reset হবে তা দেখা যায় Dashboard-এ, node tokens.mjs usage চালিয়ে, অথবা GET /v1/tokens/usage দিয়ে। বিস্তারিত আছে usage, limit ও alert পেজে।

Window বা ব্যালান্স শেষ হলে কী হয়#

Usage window শেষ: 429 window_exhausted#

{
  "error": {
    "message": "Your plan's session_5h limit has been reached. Resets in 5400s. Upgrade your plan or wait for the window to reset: https://tokens.bd/dashboard/billing",
    "type": "rate_limit_error",
    "code": "window_exhausted",
    "param": null,
    "request_id": "..."
  }
}

Response-এ একটা Retry-After header থাকে। এতে লেখা থাকে window reset হতে আর কত সেকেন্ড বাকি। Wallet-এ টাকা থাকলেও plan-এর window টপকানো যায় না: window শেষ থাকা অবস্থায় plan-এর request reset পর্যন্ত অপেক্ষা করে। tight loop-এ বারবার retry করবেন না, কারণ Retry-After কয়েক ঘণ্টাও হতে পারে।

Plan-এর credit শেষ#

প্রতিটা plan দুইভাবে সেট করা থাকে: হয় credit শেষ হলে থেমে যায়, নয়তো Wallet থেকে চালিয়ে যায় (pay-as-you-go fallback)। Fallback আছে এমন plan-এ Wallet-এ টাকা থাকলে request চলতেই থাকে। না থাকলে 402 insufficient_credits error আসবে, যতক্ষণ না পরের period শুরু হয় বা নতুন plan নেন। আপনার plan কোনটা করে সেটা নিশ্চিত না হলে Support-কে জিজ্ঞেস করুন।

Wallet-এ ব্যালান্স কম বা শূন্য#

• ব্যালান্স কম: আপনি যত max_tokens চেয়েছেন ব্যালান্স তা না কুলালে Tokens max_tokens কমিয়ে ব্যালান্সে যতটুকু কুলায় ততটুকু করে দিতে পারে (তবে 16-এর নিচে কখনো নয়)। তখন উত্তর ছোট আসে, সাধারণত finish_reason: "length" সহ। লম্বা agent session শুরুর আগে টাকা যোগ করে নিন।
• শূন্য: 402 insufficient_credits। সব 402 message-এ /dashboard/billing-এর লিংক থাকে।

অন্য billing error#

পুরো তালিকা আছে error পেজে।

Wallet-এ টাকা যোগ করা#

/dashboard/billing খুলে টাকা যোগ করুন। সর্বনিম্ন top-up ডলারে দিলে $5, টাকায় দিলে ৳500। Wallet-এর ব্যালান্স রাখা হয় USD-তে। টাকায় পেমেন্ট করলে checkout শুরু করার মুহূর্তে যে exchange rate লক হয়, সেই রেটে পরিমাণটা USD-তে বদলে নেওয়া হয়। বিস্তারিত দেখুন BDT-তে পেমেন্ট পেজে। Dashboard-এর Wallet পেজে প্রতিটা জমা আর খরচ ledger আকারে দেখা যায়।

ব্যালান্স কমে গেলে ইমেইল alert ডিফল্টে চালু থাকে, আর Wallet $5-এর নিচে নামলে সেটা যায়। চাইলে Dashboard-এর Notifications থেকে বন্ধ করতে পারেন।

Renewal আর বাতিল#

• Renewal মানে প্রতি period-এ একবারের পেমেন্ট। নিজে থেকে কিছু কাটা হয় না। Period শেষ হওয়ার আগে renewal reminder পাবেন (ওই notification চালু থাকলে), আর renew করবেন /dashboard/billing থেকে।
• বাতিল করলে plan চলতি period-এর শেষে বন্ধ হবে। তার আগ পর্যন্ত plan আর বাকি credit আপনারই থাকবে।
• Upgrade মানে অন্য একটা plan কেনা। তুলনা করতে দেখুন pricing।

Coupon আর referral#

Coupon code থাকলে plan checkout-এর সময় সেটা বসান। পেমেন্টের আগেই ছাড় দেখানো হয়।

Referral program-এ Dashboard-এর Referrals অংশে আপনি /r/<code> ধরনের একটা লিংক পাবেন। আপনার রেফার করা কেউ পেমেন্ট করলে কমিশন আপনার Wallet-এ জমা হয়। এখনকার শর্ত Referrals পেজেই দেখানো থাকে।

আরও পড়ুন#

• BDT-তে পেমেন্ট
• Usage, limit ও alert
• Error