# সাহায্য পাওয়া

> Tokens-এ সমস্যায় পড়লে কীভাবে সাহায্য পাবেন: status page দেখুন, request id খুঁজে নিন, আর দরকারি তথ্য দিয়ে Dashboard-এ support ticket খুলুন যাতে দ্রুত সমাধান হয়।

কিছু ভেঙে গেলে দ্রুত সমাধান সাধারণত তিন জায়গা থেকে আসে, এই ক্রমে: status page, troubleshooting docs, আর ঠিকঠাক তথ্য দেওয়া একটা support ticket। এই পেজে প্রতিটার কথা বলা হয়েছে, আর দেখানো হয়েছে request id কীভাবে খুঁজবেন, যা দিয়ে Support আপনার ঠিক ওই call-টা খুঁজে বের করতে পারে।

## আগে status page দেখুন

[/status](/status)-এ প্ল্যাটফর্মের প্রতিটা অংশের এখনকার অবস্থা দেখানো হয়:

- **Inference API**: `/v1` endpoint-গুলো
- **Dashboard & Auth**: Sign in করা আর Dashboard
- **Billing**: checkout ও পেমেন্ট
- **Upstream providers**: Tokens-এর পেছনের model provider-রা

এখানে গত 90 দিনের uptime ইতিহাসও আছে, যা মাপা হয় আসল probe দিয়ে। কোনো অংশ degraded থাকলে আপনার সমস্যা সম্ভবত সেটাই, তখন আলাদা ticket খোলার দরকার নেই। একটা model fail করছে কিন্তু বাকিগুলো চলছে, এমন হলে সমাধান না হওয়া পর্যন্ত অন্য model ব্যবহার করে দেখুন।

## Troubleshooting docs দেখুন

বেশিরভাগ সমস্যার কারণ আগে থেকেই জানা:

- [Error](/docs/errors) পেজে প্রতিটা error code, তার মানে আর কী করতে হবে লেখা আছে।
- [Troubleshooting](/docs/troubleshooting)-এ agent আর SDK-র সাধারণ setup সমস্যা আছে।
- [FAQ](/docs/faq)-তে billing আর অ্যাকাউন্টের প্রশ্নের উত্তর পাবেন।
- আপনার tool-এর নিজস্ব গাইডে, যেমন [Claude Code](/docs/claude-code) বা [Codex CLI](/docs/codex-cli), ওই tool-এর বিশেষ সমাধান পাবেন।

[/dashboard/connect](/dashboard/connect) থেকে live test-ও চালাতে পারেন। এটা আপনার key দিয়ে একটা ছোট request পাঠিয়ে ফলাফল দেখায়। এখানে কাজ করলে কিন্তু আপনার tool-এ না করলে বুঝবেন সমস্যা tool-এর configuration-এ, আপনার key বা অ্যাকাউন্টে নয়।

## Request id খুঁজে বের করুন

Tokens-এর প্রতিটা response-এ, সফল হোক বা না হোক, একটা `x-tokens-request-id` header থাকে। Error-এর body-তেও এটা `request_id` নামে আসে। এই id থাকলে Support সেকেন্ডের মধ্যে আপনার ঠিক request-টা খুঁজে পায়। না থাকলে তাদের সময় আর model ধরে খুঁজতে হয়।

:::code-tabs

```bash title="cURL"
curl -sS -D - -o /dev/null 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":"ping"}]}' \
  | grep -i x-tokens-request-id
```

```python title="Python"
import os
from openai import OpenAI

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

raw = client.chat.completions.with_raw_response.create(
    model="deepseek/deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "ping"}],
)
print(raw.headers.get("x-tokens-request-id"))
completion = raw.parse()  # the normal ChatCompletion object
```

```js title="Node.js"
import OpenAI from "openai";

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

const { data, response } = await client.chat.completions
  .create({
    model: "deepseek/deepseek-v4.1-flash",
    messages: [{ role: "user", content: "ping" }],
  })
  .withResponse();
console.log(response.headers.get("x-tokens-request-id"));
```

:::

Request যদি coding agent থেকে গিয়ে থাকে, তাহলে header আপনার চোখে পড়বে না। সেক্ষেত্রে Usage পেজের recent activity-তে request-টা খুঁজুন, অথবা CSV export-এ দেখুন, যেখানে Request ID নামে একটা column আছে। দেখুন [usage, limit ও alert](/docs/usage-and-alerts)।

## Support ticket খুলুন

Support ticket Dashboard-এর ভেতরেই আছে, [/dashboard/support](/dashboard/support)-এ। Ticket-এ থাকে একটা subject, একটা message আর একটা priority:

| Priority | কোন ক্ষেত্রে দেবেন                                                                         |
| -------- | ------------------------------------------------------------------------------------------ |
| High     | কোনো request-ই পাঠাতে পারছেন না, অথবা পেমেন্টের টাকা কেটেছে কিন্তু credit আসেনি           |
| Medium   | একটা model বা feature fail করছে, অথবা কিছু ঠিক নেই কিন্তু কাজ চালানোর বিকল্প আছে            |
| Low      | প্রশ্ন, billing নিয়ে ব্যাখ্যা, feature request                                            |

উত্তর আসে একই ticket thread-এ, আর আপনিও সেখানেই reply দিতে পারেন।

### কী কী দেবেন

নিচের তথ্যগুলো থাকলে সাধারণত প্রথম reply-তেই উত্তর পাওয়া যায়:

- [ ] ব্যর্থ request-এর **`x-tokens-request-id`** (একাধিক হলে সবগুলো)
- [ ] আপনি যে **model id** দিয়ে call করেছেন, ঠিক যেমন পাঠিয়েছিলেন
- [ ] ঘটনাটা **কখন** ঘটেছে, আপনার time zone সহ
- [ ] **HTTP status ও error code**, যেমন `403 model_not_allowed_on_key`, আর error message
- [ ] **কী ব্যবহার করছিলেন**: agent বা SDK ও তার version, আর endpoint (`/v1/chat/completions`, `/v1/messages`, `/v1/responses`)
- [ ] **আগে কী কী চেষ্টা করেছেন**

Billing-এর প্রশ্ন হলে এর বদলে receipt নম্বর (`REC-...`) বা পেমেন্টের transaction reference দিন।

:::danger[API key কখনো paste করবেন না]
Support-এর আপনার key লাগে না, আর ticket key রাখার নিরাপদ জায়গাও নয়। Key চেনাতে key-র নাম, অথবা [/dashboard/keys](/dashboard/keys)-এ নামের পাশে দেখানো ছোট prefix-ই যথেষ্ট। পুরো key কোথাও paste করে ফেললে সেটা rotate করে নিন।
:::

একটা ভালো ticket-এর উদাহরণ:

```text
Subject: 504 upstream_timeout on long Claude Code sessions

Since about 14:30 (UTC+6) on 3 Oct, Claude Code requests fail after ~10 minutes
with 504 upstream_timeout. Short requests work.

Model: (id copied from /models)
Request ids: 3f2c..., 9a71...
Claude Code version: (output of `claude --version`)
Tried: a different model works; the connection test at /dashboard/connect passes.
```

## Support আর কী কী সামলায়

- **Refund**, [refund policy](/refund-policy) অনুযায়ী। Receipt নম্বর দিন।
- **অ্যাকাউন্ট মুছে ফেলা**। যে অ্যাকাউন্টটা মুছতে চান সেখান থেকেই ticket খুলুন।
- **কোন model কোন provider চালায় সেই প্রশ্ন**, যদি আপনার কাজে ডেটা কীভাবে সামলানো হয় তা গুরুত্বপূর্ণ হয়। দেখুন [নিরাপত্তা আর ডেটা গোপনীয়তা](/docs/security-and-privacy)।

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