# Model catalog কীভাবে পড়বেন

> Public models list, প্রতিটা model-এর নিজের পেজ আর Dashboard-এর Model catalog কীভাবে পড়বেন: প্রতিটা column, badge ও price field, Available on-এর মানে, আর আপনার key-তে list ছোট দেখালে তার কারণ।

Tokens-এর model দেখা যায় তিন জায়গায়: [/models](/models)-এর public list, প্রতিটা model-এর নিজের পেজ `/models/<model id>`, আর আপনার Dashboard-এর ভেতরের Model catalog। তিনটাই একই catalog থেকে পড়ে, কিন্তু দেখায় আলাদা আলাদা জিনিস। এই পেজে প্রতিটা field-এর মানে বলা আছে, catalog কী দেখায় না তা বলা আছে, আর একটা key দিয়ে কোন কোন model call করা যাবে তা কীভাবে জানবেন সেটাও।

## কোন পেজে কী দেখা যায়

| পেজ                                            | কে খুলতে পারে    | দাম  | আপনার access                                              |
| ---------------------------------------------- | ---------------- | ---- | --------------------------------------------------------- |
| [/models](/models)                             | যে কেউ           | আছে  | নেই                                                       |
| `/models/<model id>`                           | যে কেউ           | আছে  | নেই                                                       |
| [Model catalog](/dashboard/models) (Dashboard) | Sign in করা user | নেই  | প্রতিটা model-এ "Access Granted" বা "Upgrade Needed"       |
| `GET /v1/models`                               | Tokens key আছে এমন কেউ | নেই  | ওই key দিয়ে ঠিক যেসব model call করা যায় তার list         |

Dashboard পেজের heading "Model Catalog & Pricing Matrix" হলেও সেখানে দামের কোনো column নেই। দাম দেখতে public পেজগুলো ব্যবহার করুন।

শুধু active model-গুলো list-এ আসে। Catalog-এ কিছু বদলালে public পেজে তা আসতে কয়েক মিনিট লাগতে পারে।

## /models-এর public list

পেজের মাথায় লেখা থাকে "Models and prices", সাথে model আর provider-এর সংখ্যা। Table-এর column-গুলো:

| Column       | কী দেখায়                                                                                                                  |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Model        | Model-এর display name, যা model-এর পেজের link। নিচে ছোট করে model id ছাপা থাকে।                                              |
| Provider     | Model-এর provider label (নিচের নোটটা দেখুন)।                                                                              |
| Context      | Context window, সংক্ষেপে লেখা: `256K`, `1M`।                                                                               |
| Input / 1M   | এক মিলিয়ন input token-এর দাম, সাথে একটা bar, যা ওই পেজের সবচেয়ে দামি দামের সাথে তুলনা করে।                                  |
| Output / 1M  | এক মিলিয়ন output token-এর দাম, একই রকম bar-সহ।                                                                            |
| Available on | যেসব plan tier-এ model-টা আছে: Free, Weekly, Monthly, Pay as you go।                                                       |
| Copy id      | একটা button, যা model id আপনার clipboard-এ copy করে।                                                                       |

Request-এর `model` field-এ এই id-ই বসাতে হয়। হাতে টাইপ না করে এখান থেকে copy করে নিন।

:::note[Provider label নিয়ে]
এই label model-এর id আর নাম দেখে হিসাব করে বের করা হয়, model-এর আসল প্রস্তুতকারক হিসেবে জমা থাকে না। যে model-এর নাম চেনা যায় না, সেটা "OmniRouter"-এর নিচে জমা হয়। একে মোটামুটি filter ধরুন, কে model-টা train করেছে তার প্রমাণ নয়।
:::

### Price field-গুলোর মানে

- **Input / 1M** হলো আপনার পাঠানো প্রতি এক মিলিয়ন token-এর দাম: prompt, এ পর্যন্ত চলা কথোপকথন, file-এর content আর tool-এর ফলাফল।
- **Output / 1M** হলো model যা লিখে ফেরত দেয় তার প্রতি এক মিলিয়ন token-এর দাম।
- একসময়ে একটা currency-তে দাম দেখায়। USD আর BDT-র মধ্যে বদলাতে currency switch ব্যবহার করুন। Switch-এ শুধু সেই currency-গুলো আসে যা প্ল্যাটফর্মে চালু আছে। BDT দাম মানে model-এর জন্য ঠিক করা BDT দাম; সেটা না থাকলে পেজ USD দামকে প্ল্যাটফর্মের exchange rate দিয়ে গুণ করে দেখায়।
- অঙ্ক দেখায় দশমিকের পর দুই ঘর (যেমন `$0.30`)। এক সেন্টের কম দাম হলে চার ঘর দেখায়।

দাম বদলায়, তাই এই পেজে কোনো দাম লেখা হয়নি। এখনকার দাম ওপরের পেজগুলোতে দেখুন।

### Search, filter আর sort

- **Search models** মেলায় display name, id আর provider label।
- **Context window**: `Any context`, `256K+` বা `1M`। `1M` বেছে নিলে শুধু সেই model-গুলো থাকে যাদের context window অন্তত দশ লক্ষ token।
- Search box-এর নিচের **Provider chip** দিয়ে একটা provider label-এ filter করা যায়। "All providers" filter মুছে দেয়।
- **Model**, **Context**, **Input / 1M** বা **Output / 1M**-এ ক্লিক করলে sort হয়। প্রথম ক্লিকে নাম A থেকে Z, context সবচেয়ে বড় থেকে, আর দাম সবচেয়ে কম থেকে সাজে। একই column-এ দ্বিতীয় ক্লিকে উল্টো ক্রমে যায়।
- নিচে লেখা থাকে "Showing N of M models"। কিছু না মিললে table-এ আসে "No models match these filters."

### তিনটা পর্যন্ত model compare করুন

তিনটা পর্যন্ত row-র checkbox টিক দিন। পেজের নিচে একটা bar আসবে। দুটো model টিক না দেওয়া পর্যন্ত **Compare** button-এ লেখা থাকে "Pick one more", তারপর "Compare 2" বা "Compare 3"। Comparison window পাশাপাশি দেখায়:

| Row            | মানে                                                                                                        |
| -------------- | ----------------------------------------------------------------------------------------------------------- |
| Provider       | Provider label                                                                                              |
| Model id       | ঠিক id-টা                                                                                                   |
| Context window | সংক্ষেপে, যেমন `1M`                                                                                         |
| Input / 1M     | Input-এর দাম                                                                                                |
| Output / 1M    | Output-এর দাম                                                                                               |
| Sample session | 25,000 input token আর 1,500 output token-এর খরচ, "a typical coding-agent turn"। সবচেয়ে সস্তাটায় "lowest" লেখা থাকে। |
| Available on   | Plan tier-গুলো                                                                                              |

Model টিক দেওয়ার সময় browser-এর ঠিকানা বদলে `/models?compare=<id>,<id>` হয়ে যায়, তাই link copy করে comparison অন্যকে পাঠাতে পারেন।

## একটা model-এর নিজের পেজ

List থেকে model খুলুন, অথবা সরাসরি `/models/<model id>`-এ যান। Active নয় এমন model-এর জন্য not-found পেজ আসে। পেজে আছে:

- Provider, display name আর ছোট একটা বর্ণনা। Catalog-এ বর্ণনা না থাকলে পেজ নাম, provider আর context window দেখে এক লাইন লিখে দেয়।
- Copy button-সহ model id, একটা **Get an API key** button আর **Compare with others**।
- চারটা tile:

| Tile                  | মানে                                                                          |
| --------------------- | ----------------------------------------------------------------------------- |
| Input, per 1M tokens  | মূল currency-তে input-এর দাম, নিচে ছোট অক্ষরে অন্য currency-র দাম              |
| Output, per 1M tokens | Output-এর দাম, একই ভাবে                                                       |
| Context window        | সংক্ষেপে, নিচে token-এর ঠিক সংখ্যা                                            |
| Available on          | কয়টা tier-এ model-টা আছে, সাথে তাদের নাম                                      |

- **What it costs in practice**: তিন ধরনের কাজে model-এর এখনকার দামে কত খরচ হবে, প্রতিটা চালু currency-তে। এগুলো উদাহরণ, ভবিষ্যদ্বাণী নয়; input আর output-এর আসল অনুপাত নির্ভর করে আপনার agent আর কাজের ওপর।

| Workload              | Token                  |
| --------------------- | ---------------------- |
| One agent turn        | 25K input, 1.5K output |
| An hour of agent work | 1M input, 60K output   |
| A month of daily use  | 20M input, 1.2M output |

- **Use this model**: Claude Code, Codex, OpenCode, Cursor, OpenAI Python SDK আর curl-এর তৈরি setup, প্রতিটায় এই model-এর id বসানো। শুধু key-টা নিজের একটা দিয়ে বদলে নিন। দেখুন [quickstart](/docs/quickstart)।
- **Similar models**: চারটা পর্যন্ত। আগে একই provider label-এর model, তারপর output-এর দামে যেগুলো সবচেয়ে কাছাকাছি, সাথে তাদের compare করার link।

## Catalog যা দেখায় না

Catalog ধরে কোনো পরিকল্পনা করার আগে এগুলো মাথায় রাখুন:

- **Output limit নেই।** Catalog-এ প্রতিটা model-এর একটাই মাপ আছে, context window। সর্বোচ্চ output কত লম্বা হতে পারে তা list-এ নেই।
- **Cache-এর দাম নেই।** শুধু input আর output-এর দাম দেখানো হয়। Public পেজ বা Dashboard-এর Model catalog কোথাও cache-read বা cache-write-এর দাম নেই। আপনার usage export-এ cache-read token আলাদা column-এ গোনা হয়; দেখুন [usage, limit আর alert](/docs/usage-and-alerts)।
- **Capability badge নেই।** Tool calling, image input, reasoning বা streaming-এর জন্য কোনো tag বা filter নেই। Public পেজের search box শুধু নাম, id আর provider মেলায়।

কোন model কীসে ভালো, আর কোনগুলো ছবি নেয়, তা জানতে পড়ুন [model বাছাই](/docs/choosing-a-model)। নিজের কাজে model কেমন চলে দেখতে [Playground](/dashboard/playground)-এ খুলে দেখুন।

### Feature অনুযায়ী model খোঁজা

1. কোন শর্তটা সবচেয়ে জরুরি তা ঠিক করুন: বড় context, কম দাম, নাকি ছবির মতো কোনো input।
2. Context-এর জন্য [/models](/models)-এ **Context window** filter (`256K+` বা `1M`) ব্যবহার করুন। দামের জন্য **Input / 1M** বা **Output / 1M** দিয়ে sort করুন।
3. Catalog যে feature-এর কথা বলে না (tool calling, vision, reasoning), তার জন্য শুরু করুন [model বাছাই](/docs/choosing-a-model) পেজ থেকে। তারপর ভরসা করার আগে model-টাকে একটা test request পাঠিয়ে দেখুন। Tool use নিয়ে আলাদা পেজ আছে: [tool calling](/docs/tool-calling)।
4. বাছাই করা কয়েকটাকে comparison window-তে মেলান, আর sample session-এর খরচকে মোটামুটি আন্দাজ হিসেবে নিন।

## Dashboard-এর Model catalog

Sidebar থেকে [Model catalog](/dashboard/models) খুলুন। এটা বলে আপনার অ্যাকাউন্ট কী কী ব্যবহার করতে পারে।

ওপরে তিনটা tile:

| Tile                 | মানে                                                                                                                                                                                   |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Active Coding Models | Catalog-এ কয়টা active model আছে                                                                                                                                                       |
| Catalog Source       | load হলে `Live Database`, load চলতে থাকলে `Loading`, request ব্যর্থ হলে `Unavailable`                                                                                                  |
| Your Current Tier    | আপনার active plan-এর tier বড় হাতের অক্ষরে (যেমন `MONTHLY`), আর active plan না থাকলে `PUBLIC`। Wallet-এর ব্যালান্স শূন্যের বেশি হলে `Wallet Active` badge আসে                              |

Controls:

- একটা text box ("Filter models by alias or capability..."), যা model-এর id, নাম বা বর্ণনা মেলায়। এটা capability field খোঁজে না, কারণ catalog-এ সেটা নেই; তবে বর্ণনার শব্দ মিলে যেতে পারে।
- Tab: **All**, **Free Starter** (Free tier-এ থাকা model), **Paid Plans** (Weekly বা Monthly) আর **Wallet Allowed** (Pay as you go)।
- **Grid** আর **Table** view, আর একটা refresh button।

প্রতিটা model-এ দেখায় তার নাম, হাজারে লেখা context window (1M window-র জন্য `1000k context`), copy button-সহ id, আর tier-এর আসল নামগুলো (`free`, `weekly`, `monthly`, `pay_as_you_go`)। **Try in Playground** [Playground](/dashboard/playground) খুলে দেয়। Model-টা ওখানে গিয়ে নিজে বেছে নিন; Playground পেজ link থেকে model পড়ে না। Table view-তে column আছে Model Name & Alias, Context Window, Allowed Tiers, Status আর Actions।

### Access Granted আর Upgrade Needed

আপনার Wallet-এর ব্যালান্স শূন্যের বেশি হলে, অথবা আপনার plan-এর tier model-এর list-এ থাকলে status badge-এ **Access Granted** (table-এ **Available**) দেখায়। নইলে দেখায় **Upgrade Needed** (**Upgrade**)।

:::warning[Badge-টাকে ইঙ্গিত হিসেবে নিন]
Dashboard badge-টা হিসাব করে শুধু তখনই, যখন আপনার active plan আছে। Plan না থাকলে প্রতিটা model-এ Upgrade Needed দেখায়, এমনকি Wallet দিয়ে call করা গেলেও। Pay as you go-তে model-টা চালু আছে কি না, badge তাও যাচাই করে না। সঠিক উত্তরের জন্য যে key ব্যবহার করবেন তা দিয়ে `GET /v1/models` call করুন (পরের অংশ)।
:::

## Key অনুযায়ী list কেন আলাদা হয়

Public পেজ সবার জন্য এক। কিন্তু কোন key দিয়ে কোন model call করা যাবে, সেই list এক নয়। `GET /v1/models` আপনার পাঠানো key-র model-গুলো ফেরত দেয়:

```bash
curl -s https://tokens.bd/v1/models \
  -H "Authorization: Bearer $TOKENS_API_KEY" | jq -r '.data[].id'
```

Model-টা ওই list-এ আসে যখন এই সবগুলো মেলে:

1. Catalog-এ model-টা active।
2. Key-তে allowed-models list থাকলে model-টা তাতে আছে। দেখুন [API key](/docs/api-keys)।
3. আপনার active plan-এর tier model-এর **Available on** list-এ আছে, অথবা Wallet-এর ব্যালান্স শূন্যের বেশি আর model-এর list-এ **Pay as you go** চালু আছে।

তাই একই অ্যাকাউন্টের দুটো key আলাদা list দেখতে পারে, আর public পেজে থাকা model আপনার key-তে নাও থাকতে পারে। কারণগুলো আছে [model ও usage endpoint](/docs/models-and-usage) পেজে। Key যে model ব্যবহার করতে পারে না তা call করলে `model_not_allowed_on_key` বা কোনো plan error আসে; দেখুন [error](/docs/errors)।

## আরও পড়ুন

- [Model বাছাই](/docs/choosing-a-model)
- [Model ও usage endpoint](/docs/models-and-usage)
- [API key](/docs/api-keys)
- [Plan, credit আর Wallet](/docs/plans-and-wallet)

---
Page: https://tokens.bd/bn/docs/model-catalog