# Platform-এর পরিচিতি

> Tokens কী, আপনার tool থেকে request কীভাবে model provider পর্যন্ত যায়, কোন জিনিসের হিসাব রাখা হয়, আর প্রথম call-এর আগে যে কয়েকটা ধারণা জেনে রাখা দরকার।

Tokens একটা AI model gateway। একটা API key দিয়ে আপনি অনেক provider-এর model পান OpenAI-compatible আর Anthropic-compatible endpoint-এর মাধ্যমে, আর পেমেন্ট করতে পারেন USD বা BDT-তে। বাকি docs বুঝতে সুবিধা হবে বলে এই পাতায় platform-টা কীভাবে কাজ করে তা বলা হয়েছে।

## Tokens কী

বেশিরভাগ coding agent আর SDK দুটো ভাষার একটা বোঝে: OpenAI API অথবা Anthropic Messages API। Tokens দুটোই বোঝে। কোনো একটা provider-এর বদলে আপনি tool-টাকে Tokens-এ পয়েন্ট করান, একটাই `tok_live_` key ব্যবহার করেন, আর `model` field বদলে আপনার plan বা Wallet যে model-গুলো কাভার করে তার যেকোনোটা বেছে নেন।

| কোনটা ব্যবহার করছেন      | Base URL               | সাধারণত যেসব client                                               |
| ------------------------ | ---------------------- | ----------------------------------------------------------------- |
| OpenAI-compatible API    | `https://tokens.bd/v1` | OpenAI SDKs, OpenCode, Codex CLI, Cursor, Cline, Aider, Continue  |
| Anthropic-compatible API | `https://tokens.bd`    | Claude Code, Anthropic SDK (`/v1/messages` এটা নিজেই জুড়ে নেয়)   |

দামসহ সব model-এর তালিকা আছে [model catalog](/models)-এ। Plan আর টাকা যোগ করার তথ্য আছে [pricing](/pricing)-এ।

## একটা request কীভাবে যায়

1. **আপনার tool request পাঠায়** `https://tokens.bd/v1/...`-এ, আর key থাকে `Authorization: Bearer` বা `x-api-key` header-এ।
2. **Tokens যাচাই করে**: key ঠিক আছে ও active কি না, model-টা ওই key আর আপনার plan-এ allowed কি না, rate limit ও usage window-এর ভেতরে আছেন কি না, আর খরচ মেটানোর মতো credit আছে কি না।
3. **Tokens request-টা upstream source-এ পাঠায়**। সেই source যদি 429, 502, 503 বা 504 দেয়, কিংবা connection কেটে দেয়, Tokens একই model-এর অন্য একটা source-এ নিজে থেকেই আবার চেষ্টা করে।
4. **Response আপনার tool-এ ফিরে আসে** কোনো বদল ছাড়া (streaming request হলে SSE হিসেবে), আর যেতে যেতেই Tokens token গুনে রাখে।
5. **খরচ মেটানো হয়** response শেষ হলে, আপনার plan-এর credit বা Wallet থেকে।

প্রতিটা response-এ একটা `x-tokens-request-id` header থাকে। কিছু গোলমাল হলে এটা রেখে দিন। [support](/docs/support) এটা দিয়েই সবচেয়ে তাড়াতাড়ি আপনার request খুঁজে পায়।

:::note
আপনার আর provider-এর মাঝখানে Tokens একটা বাড়তি network hop যোগ করে। লম্বা request নিয়ে চিন্তা নেই (response header আসতে 600 সেকেন্ড পর্যন্ত লাগতে পারে), কিন্তু provider-কে সরাসরি call করার চেয়ে কম latency আশা করবেন না।
:::

## API কী কী কাভার করে

যেসব endpoint চলে: `POST /v1/chat/completions`, `POST /v1/messages`, `POST /v1/responses`, `POST /v1/completions` (legacy), `POST /v1/embeddings` (শুধু embedding model-এর জন্য), `GET /v1/models` আর `GET /v1/tokens/usage`।

যা চলে না: image generation, audio, files, batches, assistants, fine-tuning আর moderations। এগুলোতে call করলে `404 unsupported_endpoint` আসবে। Browser থেকে call-ও চলে না, কারণ response-এ CORS header থাকে না। Tokens-কে call করুন server, script বা CLI tool থেকে।

## কীসের হিসাব রাখা হয়

`/v1` থেকে আসা এবং Dashboard-এর playground থেকে করা, প্রতিটা inference request-এর হিসাব Tokens রাখে। প্রতিটা request-এর জন্য এগুলো লেখা থাকে:

- model, input token, output token আর cache-read token
- সেই model-এর catalog দাম অনুযায়ী খরচ
- latency, সময়, কোন key ব্যবহার হয়েছে আর request id

এই তথ্যই আপনি usage dashboard আর CSV export-এ দেখতে পান। Prompt আর response-এর লেখা জমানো হয় না। বিস্তারিত পাবেন [security and data privacy](/docs/security-and-privacy)-তে।

`GET /v1/tokens/usage`-এর মতো read-only call-এর হিসাব ধরা হয় না।

## মূল ধারণা

### API key

`tok_live_` দিয়ে শুরু হওয়া একটা secret। [/dashboard/keys](/dashboard/keys)-এ তৈরি করার সময় এটা একবারই দেখানো হয়। চাইলে key-তে মাসিক spend cap আর allowed model-এর তালিকা দেওয়া যায়। বিস্তারিত [API keys](/docs/api-keys)-এ।

### Model id

Model-এর নাম লেখা হয় `provider/model` ধাঁচের alias দিয়ে, যেমন `deepseek/deepseek-v4.1-flash`। `model` field-এ এই alias-ই বসে। এটা সবসময় provider-এর নিজের id-র সঙ্গে মেলে না, তাই [/models](/models) থেকে বা `GET /v1/models` থেকে copy করুন। ওই call আপনার key যেসব model চালাতে পারে ঠিক সেগুলোই ফেরত দেয়। কোনটা নেবেন বুঝতে [Choosing a model](/docs/choosing-a-model) দেখুন।

### Plan নাকি Wallet

Usage-এর খরচ মেটানোর দুটো উপায় আছে, চাইলে দুটোই রাখতে পারেন:

- **Plan** হলো weekly বা monthly সাবস্ক্রিপশন। এতে একটা credit allowance পাওয়া যায় (default-এ 100 credit = 1 USD), আর কিছু plan-এ usage window-ও থাকে।
- **Wallet** হলো USD-তে আগে থেকে ভরে রাখা ব্যালান্স, pay-as-you-go ব্যবহারের জন্য। USD বা BDT, যেকোনোটায় টাকা যোগ করা যায়।

বিস্তারিত [plans, credits and wallet](/docs/plans-and-wallet)-এ।

### Usage windows

কিছু plan তাদের allowance সময়ের সঙ্গে ভাগ করে দেয় window দিয়ে: চলমান 5 ঘণ্টার session, weekly সীমা আর monthly সীমা। কোনো window শেষ হয়ে গেলে request-এ `429 window_exhausted` আসে, সঙ্গে `Retry-After` header বলে দেয় reset হতে কত সময় লাগবে। প্রতিটা window আপনি দেখতে পাবেন Dashboard-এ, `GET /v1/tokens/usage` call করে, অথবা CLI-র `usage` command-এ। বিস্তারিত [usage, limits and alerts](/docs/usage-and-alerts)-এ।

## এরপর কোথায় যাবেন

- [Quickstart](/docs/quickstart): কয়েক মিনিটে key তৈরি করে প্রথম request পাঠান।
- [Tokens CLI](/docs/tokens-cli): এক command-এ OpenCode, Claude Code, Codex CLI আর Crush সেটআপ করুন।
- [Claude Code](/docs/claude-code), [Codex CLI](/docs/codex-cli), [OpenCode](/docs/opencode), [Cursor](/docs/cursor): প্রতিটা agent-এর আলাদা setup guide।
- [Errors](/docs/errors): সব error code আর কখন কী করবেন।

---
Page: https://tokens.bd/bn/docs/overview