Quickstart

এই quickstart আপনাকে নতুন অ্যাকাউন্ট থেকে একটা কাজ করা API call পর্যন্ত নিয়ে যাবে, তারপর coding agent connect করা পর্যন্ত। লাগবে একটা terminal, আর SDK-র উদাহরণগুলোর জন্য নতুন Python 3 বা Node.js 18+।

1. অ্যাকাউন্ট খুলুন#

tokens.bd/register-এ গিয়ে ইমেইল বা Google দিয়ে অ্যাকাউন্ট খুলুন। ইমেইল ঠিকানা verify করে নিন, কারণ verify না হওয়া পর্যন্ত API key বানানো যায় না।

2. Credit যোগ করুন: plan বা Wallet-এ টাকা#

Usage-এর খরচ মেটানোর কিছু না থাকলে key কাজ করে না। /dashboard/billing-এ গিয়ে যেকোনো একটা বেছে নিন (চাইলে দুটোই):

• plan-এ সাবস্ক্রাইব করুন: weekly বা monthly credit allowance পাবেন। তুলনা দেখুন pricing-এ।
• Wallet-এ টাকা যোগ করুন: pay-as-you-go ব্যবহারের জন্য। সর্বনিম্ন $5 বা ৳500 যোগ করতে হয়।

দাম দেখানো হয় USD, BDT-এ। পেমেন্টের মাধ্যম: Manual Payment (bKash, Nagad)। টাকায় পেমেন্ট করতে চাইলে আগে paying in BDT পড়ে নিন।

3. API key বানান#

/dashboard/keys-এ গিয়ে key তৈরি করুন। এমন একটা নাম দিন যা পরে চিনতে পারবেন ("laptop", "ci", "staging-bot")। চাইলে মাসিক spend cap দিতে পারেন, আর key-টাকে নির্দিষ্ট কয়েকটা model-এ সীমাবদ্ধ করতে পারেন। দুটোই optional, আর key তৈরি হয়ে গেলে দুটোর কোনোটাই আর বদলানো যায় না। কখন এগুলো কাজে লাগে তা API keys-এ বলা আছে।

Secret-টা tok_live_ দিয়ে শুরু হয় আর দেখানো হয় একবারই। এখনই copy করে একটা environment variable-এ রেখে দিন:

export TOKENS_API_KEY="tok_live_your_key"

$env:TOKENS_API_KEY = "tok_live_your_key"

4. প্রথম request পাঠান#

OpenAI-compatible base URL হলো https://tokens.bd/v1। উদাহরণে deepseek/deepseek-v4.1-flash ব্যবহার করা হয়েছে। আপনার plan বা Wallet যেটা কাভার করে, /models থেকে সেরকম যেকোনো model id বসিয়ে নিতে পারেন।

curl https://tokens.bd/v1/chat/completions \
  -H "Authorization: Bearer $TOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Say hello in one short sentence."}]
  }'

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://tokens.bd/v1",
    api_key=os.environ["TOKENS_API_KEY"],
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)
print(response.choices[0].message.content)

// npm install openai   (save as hello.mjs, run: node hello.mjs)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://tokens.bd/v1",
  apiKey: process.env.TOKENS_API_KEY,
});

const response = await client.chat.completions.create({
  model: "deepseek/deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Say hello in one short sentence." }],
});
console.log(response.choices[0].message.content);

সফল হলে সাধারণ OpenAI chat completion response পাবেন। তার বদলে error এলে error.code field-এ কারণ লেখা থাকে:

পুরো তালিকা আছে errors-এ।

আপনার key যেসব model চালাতে পারে তার তালিকা#

curl https://tokens.bd/v1/models -H "Authorization: Bearer $TOKENS_API_KEY"

data-র প্রতিটা entry-র id ঠিক সেটাই, যা আপনি model-এ বসাবেন।

5. Coding agent connect করুন#

OpenCode, Claude Code, Codex CLI আর Crush-এর জন্য সবচেয়ে সহজ উপায় Tokens CLI। এটা browser দিয়ে আপনাকে Sign in করায়, default model বেছে নিতে দেয়, আর agent-গুলোর config file বদলায়, প্রতিটার একটা backup রেখে:

curl -fsSL https://tokens.bd/cli/tokens.mjs -o tokens.mjs && node tokens.mjs setup --base-url https://tokens.bd

iwr https://tokens.bd/cli/tokens.mjs -OutFile tokens.mjs; node tokens.mjs setup --base-url https://tokens.bd

CLI ঠিক কী কী বদলায় তা দেখুন Tokens CLI-তে। নিজে হাতে সেটআপ করতে চাইলে, বা অন্য কোনো tool ব্যবহার করলে, /dashboard/connect-এ প্রতিটা agent-এর জন্য copy-paste করার মতো settings আছে। বিস্তারিত guide-গুলো:

• Claude Code (Anthropic-compatible, base URL https://tokens.bd)
• Codex CLI, OpenCode, Crush
• আরও: Cursor, Cline, Roo Code, Kilo Code, Continue, Zed, Aider

এই পাতা থেকেই key test করুন#

নিচে আপনার key paste করলে gateway দিয়ে একটা ছোট test request যাবে। এতে কয়েকটা token খরচ হবে।

পরের ধাপ#

• Choosing a model: কোন কাজে কোন model।
• Usage, limits and alerts: কোনো agent-কে key দেওয়ার আগে খরচের উপর নজর রাখুন আর alert সেট করুন।
• Streaming আর tool calling: agent যেসব API-র উপর নির্ভর করে তার বিস্তারিত।