# Quickstart

> অ্যাকাউন্ট খুলুন, credit যোগ করুন, API key বানান, তারপর cURL, Python বা Node.js দিয়ে Tokens-এ প্রথম request পাঠান এবং আপনার coding agent connect করুন।

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

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

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

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

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

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

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

## 3. API key বানান

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

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

:::code-tabs

```bash title="macOS / Linux"
export TOKENS_API_KEY="tok_live_your_key"
```

```powershell title="Windows PowerShell"
$env:TOKENS_API_KEY = "tok_live_your_key"
```

:::

:::warning
Key কখনো এমন code-এ paste করবেন না যা commit করবেন, আর কখনো web page-এ দেবেন না। Browser থেকে Tokens-এ call চলে না; call করুন server, script বা CLI থেকে।
:::

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

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

:::code-tabs

```bash title="cURL"
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."}]
  }'
```

```python title="Python"
# 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)
```

```js title="Node.js"
// 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-এ কারণ লেখা থাকে:

| Code                                  | সাধারণত কারণ                                                  | কী করবেন                                                         |
| ------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- |
| `invalid_api_key`                     | Typo আছে, অথবা এই shell-এ variable set করা নেই                | `echo $TOKENS_API_KEY` চালিয়ে দেখুন, তারপর আবার export করুন      |
| `model_not_found`                     | Model id ভুল                                                  | `GET /v1/models` থেকে id copy করুন                                |
| `tier_permission_denied`              | আপনার plan-এ ওই model নেই, আর Wallet-ও খালি                    | অন্য model নিন, অথবা টাকা যোগ করুন                                |
| `no_funding` / `insufficient_credits` | কোনো plan নেই, Wallet-এও ব্যালান্স নেই                         | [/dashboard/billing](/dashboard/billing)-এ গিয়ে সাবস্ক্রাইব করুন বা টাকা যোগ করুন |

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

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

```bash
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 রেখে:

:::code-tabs

```bash title="macOS / Linux"
curl -fsSL https://tokens.bd/cli/tokens.mjs -o tokens.mjs && node tokens.mjs setup --base-url https://tokens.bd
```

```powershell title="Windows PowerShell"
iwr https://tokens.bd/cli/tokens.mjs -OutFile tokens.mjs; node tokens.mjs setup --base-url https://tokens.bd
```

:::

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

- [Claude Code](/docs/claude-code) (Anthropic-compatible, base URL `https://tokens.bd`)
- [Codex CLI](/docs/codex-cli), [OpenCode](/docs/opencode), [Crush](/docs/crush)
- আরও: [Cursor](/docs/cursor), [Cline](/docs/cline), [Roo Code](/docs/roo-code), [Kilo Code](/docs/kilo-code), [Continue](/docs/continue), [Zed](/docs/zed), [Aider](/docs/aider)

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

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

::connection-tester

## পরের ধাপ

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

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