CheapTokens-এর সাথে আপনার প্রথম API অনুরোধ

এই গাইডটি আপনাকে একটি নতুন অ্যাকাউন্ট থেকে একটি কার্যকর অনুরোধ পর্যন্ত নিয়ে যায়। আপনার একটি ইমেল ঠিকানা, একটি ছোট ব্যালেন্স এবং একটি টার্মিনাল প্রয়োজন। APIটি OpenAI-সামঞ্জস্যপূর্ণ, তাই আপনি যদি আগে OpenAI কল করে থাকেন, শুধুমাত্র দুটি জিনিস পরিবর্তিত হয়: বেস URL এবং কী।

আপনার যা প্রয়োজন#

• একটি অ্যাকাউন্ট। সাইন-আপ ইমেলের মাধ্যমে — কোনো পাসওয়ার্ড নেই, আমরা আপনাকে একটি সাইন-ইন লিঙ্ক পাঠাই।
• একটি ব্যালেন্স। কোনো সাবস্ক্রিপশন নেই: আপনি একটি USD ব্যালেন্স টপ আপ করেন এবং প্রতিটি অনুরোধ মডেলের নির্দিষ্ট হারে প্রতি টোকেনে চার্জ করা হয়।
• একটি API কী আপনার ড্যাশবোর্ড থেকে।

ধাপ ১. একটি অ্যাকাউন্ট তৈরি করুন এবং টপ আপ করুন#

সাইন-আপ পৃষ্ঠা খুলুন, আপনার ইমেল লিখুন এবং চিঠির লিঙ্ক অনুসরণ করুন। ড্যাশবোর্ডে Top up চাপুন এবং কীভাবে পেমেন্ট করবেন তা চয়ন করুন:

• ক্রিপ্টো — $5 থেকে; 5% ডিপোজিট ফি প্রযোজ্য।
• কার্ড — একটি অংশীদারের মাধ্যমে, যিনি তার নিজস্ব ফি চার্জ করেন।

ধাপ ২. আপনার API কী কপি করুন#

আপনার ব্যালেন্স শূন্যের বেশি হলেই — টপ-আপ বা রেফারেল বোনাসের পরে — ড্যাশবোর্ড আপনার API কী তৈরি করে একবার দেখায়। এটি সঙ্গে সঙ্গে কপি করুন এবং আপনার কোডের বাইরে রাখুন, উদাহরণস্বরূপ একটি পরিবেশ পরিবর্তনশীলে:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

যদি কীটি ফাঁস হয়, Rotate চাপুন: আপনি একটি নতুন কী পান এবং পুরানোটি কাজ করা বন্ধ করে দেয়।

ধাপ ৩. একটি মডেল চয়ন করুন#

অনুরোধগুলির সম্পূর্ণ মডেল আইডি প্রয়োজন — স্ল্যাশের আগে উপসর্গ সহ, ঠিক যেমন API এটি তালিকাভুক্ত করে। লেখার সময় ক্যাটালগ (অক্টোবর ২০২৬):

ক্যাটালগ পরিবর্তিত হতে পারে, তাই সত্যের উৎস হল API নিজেই। এই অনুরোধের কোনো কী প্রয়োজন নেই:

curl https://api.cheaptokens.dev/v1/models

ধাপ ৪. অনুরোধ পাঠান#

curl#

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hello in three languages"}]
  }'

একটি সফল উত্তর স্ট্যান্ডার্ড Chat Completions ফর্ম্যাটে ফিরে আসে। একটি সংক্ষিপ্ত উদাহরণ — আপনার পাঠ্য, আইডি এবং সংখ্যাগুলি ভিন্ন হবে, এবং প্রতিক্রিয়াটি অতিরিক্ত পরিষেবা ক্ষেত্র বহন করতে পারে:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• পাঠ্যটি choices[0].message.content-এ রয়েছে।
• টোকেন ব্যবহার usage-এ রয়েছে: prompt_tokens — ইনপুট, completion_tokens — আউটপুট। এই দুটি সংখ্যার জন্য অনুরোধ চার্জ করা হয়।

Python#

pip install openai দিয়ে অফিসিয়াল SDK ইনস্টল করুন এবং এটি আমাদের বেস URL-এ নির্দেশ করুন:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

npm install openai দিয়ে SDK ইনস্টল করুন:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Anthropic-শৈলীর ক্লায়েন্ট#

Anthropic Messages API-এর জন্য নির্মিত ক্লায়েন্টগুলি /v1 ছাড়া রুট ঠিকানা ব্যবহার করে — https://api.cheaptokens.dev — এবং x-api-key হেডারে কী পাঠায়। Anthropic SDKs নিজেরাই পাথ এবং হেডার যোগ করে; আপনি শুধুমাত্র বেস URL এবং কী সেট করেন।

যদি কিছু ভুল হয়ে যায়#

• 401 Invalid API key — কীটি ভুল টাইপ করা হয়েছে বা ঘোরানো হয়েছে। পরীক্ষা করুন যে আপনি এটি সম্পূর্ণ পেস্ট করেছেন; ড্যাশবোর্ড একটি কী শুধুমাত্র একবার দেখায়, তাই যদি এটি হারিয়ে যায়, Rotate চেপে একটি নতুন পান।
• 402 — ব্যালেন্স ব্যবহৃত হয়েছে, বা অনুরোধ Authorization হেডার ছাড়া চলে গেছে।
• 400 Model "…" not found — /v1/models থেকে সম্পূর্ণ মডেল আইডি ব্যবহার করুন, স্ল্যাশের আগে উপসর্গ সহ।
• 404 — ঠিকানা পরীক্ষা করুন: OpenAI-শৈলীর ক্লায়েন্টদের বেস URL-এর শেষে /v1 প্রয়োজন।

আরও কেস এবং সমাধান: সাধারণ সংযোগ ত্রুটি এবং কীভাবে সেগুলি ঠিক করবেন।

এটির খরচ কত#

প্রতিটি অনুরোধ ইনপুট এবং আউটপুট টোকেনের জন্য আলাদাভাবে চার্জ করা হয়, মডেলের প্রতি মিলিয়ন টোকেনের হারে। বর্তমান মূল্য — মূল্য পৃষ্ঠা-এর মতো একই ডেটা:

পরবর্তী ধাপ: একটি কোডিং এজেন্ট সংযুক্ত করুন, উদাহরণস্বরূপ Cline, অথবা একটি AI এজেন্টের খরচ কত হবে তা অনুমান করতে শিখুন।

অন্য ডেভেলপারদের CheapTokens সুপারিশ করেন? রেফারেল প্রোগ্রাম-এ আপনি তাদের টপ-আপের একটি শতাংশ পান।