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

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

আগে status page দেখুন#

/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 পেজে প্রতিটা error code, তার মানে আর কী করতে হবে লেখা আছে।
• Troubleshooting-এ agent আর SDK-র সাধারণ setup সমস্যা আছে।
• FAQ-তে billing আর অ্যাকাউন্টের প্রশ্নের উত্তর পাবেন।
• আপনার tool-এর নিজস্ব গাইডে, যেমন Claude Code বা Codex CLI, ওই tool-এর বিশেষ সমাধান পাবেন।

/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 ধরে খুঁজতে হয়।

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

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

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।

Support ticket খুলুন#

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

উত্তর আসে একই 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 দিন।

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

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 অনুযায়ী। Receipt নম্বর দিন।
• অ্যাকাউন্ট মুছে ফেলা। যে অ্যাকাউন্টটা মুছতে চান সেখান থেকেই ticket খুলুন।
• কোন model কোন provider চালায় সেই প্রশ্ন, যদি আপনার কাজে ডেটা কীভাবে সামলানো হয় তা গুরুত্বপূর্ণ হয়। দেখুন নিরাপত্তা আর ডেটা গোপনীয়তা।