# Plan, credit আর Wallet

> Tokens-এ subscription plan, credit, usage window আর pay-as-you-go Wallet কীভাবে কাজ করে, window বা ব্যালান্স শেষ হলে কী হয়, এবং renewal, বাতিল ও coupon-এর নিয়ম।

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

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

|            | Plan                                                      | Wallet                                         |
| ---------- | --------------------------------------------------------- | ---------------------------------------------- |
| কী কেনেন   | সাপ্তাহিক বা মাসিক credit allowance                       | USD ব্যালান্স                                   |
| কার জন্য ভালো | নিয়মিত রোজকার ব্যবহার, খরচ আগে থেকে জানা               | মাঝে মাঝে ব্যবহার, অথবা plan-এর ওপর বাড়তি      |
| সীমা       | Plan-এর usage window, rate limit ও concurrency            | Rate limit ও concurrency                       |
| Model      | Plan-এ যে model-গুলো আছে                                  | pay-as-you-go-এ বিক্রি হওয়া সব model           |
| Renewal    | প্রতি period-এ একবার পেমেন্ট, renew আপনিই করবেন           | যখন ইচ্ছা টাকা যোগ করুন                         |

দুটোই একসাথে রাখতে পারেন। 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](/models) পেজে।

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

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

কিছু plan-এ নির্দিষ্ট model-এর জন্য আলাদা allowance থাকে, কিছু model ফ্রি থাকে, আবার কোনো model-এ deal চলে। কোন plan-এ কী আছে তা [pricing](/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](/models)-এর দামে।
- **ফ্রি 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 থেকে কাটবে।

```json
{
  "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-এ এগুলোর যেকোনোটা থাকতে পারে:

| Window         | কখন reset হয়                                                                                        |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| 5-hour session | আগের session শেষ হওয়ার পর আপনার প্রথম request থেকে শুরু হয়, আর ঠিক 5 ঘণ্টা পরে reset হয়            |
| Weekly         | প্রতি সোমবার 00:00 UTC-তে                                                                           |
| Monthly        | আপনার billing period-এর শেষে                                                                        |

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

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

### Usage window শেষ: 429 `window_exhausted`

```json
{
  "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](/docs/support)-কে জিজ্ঞেস করুন।

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

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

### অন্য billing error

| HTTP | Code                         | মানে                                                                               |
| ---- | ---------------------------- | ---------------------------------------------------------------------------------- |
| 402  | `no_funding`                 | চালু কোনো plan নেই, Wallet-এও ব্যালান্স নেই                                         |
| 402  | `outstanding_debt`           | আগের কোনো request-এর কিছু টাকা বাকি আছে; টাকা যোগ করলে সেটা মিটে যাবে               |
| 429  | `model_limit_reached`        | আপনার plan-এ এই model-এর allowance শেষ; অন্য model চলবে                            |
| 403  | `tier_permission_denied`     | আপনার plan-এ এই model নেই, আর Wallet-এও টাকা নেই যা দিয়ে এটা চালানো যায়           |
| 403  | `monthly_spend_cap_exceeded` | এটা ওই key-এর নিজের monthly cap, আপনার অ্যাকাউন্টের নয়; দেখুন [API key](/docs/api-keys) |

পুরো তালিকা আছে [error](/docs/errors) পেজে।

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

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

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

## Renewal আর বাতিল

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

## Coupon আর referral

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

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

## আরও পড়ুন

- [BDT-তে পেমেন্ট](/docs/paying-in-bdt)
- [Usage, limit ও alert](/docs/usage-and-alerts)
- [Error](/docs/errors)

---
Page: https://tokens.bd/bn/docs/plans-and-wallet