Platform-এর পরিচিতি

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-গুলো কাভার করে তার যেকোনোটা বেছে নেন।

দামসহ সব model-এর তালিকা আছে model catalog-এ। Plan আর টাকা যোগ করার তথ্য আছে 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 এটা দিয়েই সবচেয়ে তাড়াতাড়ি আপনার request খুঁজে পায়।

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-তে।

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

মূল ধারণা#

API key#

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

Model id#

Model-এর নাম লেখা হয় provider/model ধাঁচের alias দিয়ে, যেমন deepseek/deepseek-v4.1-flash। model field-এ এই alias-ই বসে। এটা সবসময় provider-এর নিজের id-র সঙ্গে মেলে না, তাই /models থেকে বা GET /v1/models থেকে copy করুন। ওই call আপনার key যেসব model চালাতে পারে ঠিক সেগুলোই ফেরত দেয়। কোনটা নেবেন বুঝতে 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-এ।

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-এ।

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

• Quickstart: কয়েক মিনিটে key তৈরি করে প্রথম request পাঠান।
• Tokens CLI: এক command-এ OpenCode, Claude Code, Codex CLI আর Crush সেটআপ করুন।
• Claude Code, Codex CLI, OpenCode, Cursor: প্রতিটা agent-এর আলাদা setup guide।
• Errors: সব error code আর কখন কী করবেন।