সঠিক মডেল id খুঁজতে GET /v1/models দিয়ে মডেল তালিকা করুন

আপনার কোড এমন একটি মডেল নামে 404 রিটার্ন করছে যা অন্য কারও উদাহরণে ঠিকঠাক দেখাচ্ছিল। API-কেই জিজ্ঞাসা করুন: https://api.cheaptokens.dev/v1/models-এ একটি GET রিকোয়েস্ট আপনার কল করার মতো মডেলগুলোর তালিকা দেয়, তাদের কনটেক্সট ও আউটপুট সীমাসহ। উত্তর থেকে id কপি করুন, মুখস্থ থেকে নয়, এবং max_tokens সেট করার আগে সীমাটি যাচাই করুন।

ডকুমেন্টেশন পেজ (CheapTokens docs, ২৮ অক্টোবর ২০২৬-এ যাচাইকৃত) GET /v1/models-কে কলযোগ্য মডেলগুলোর তালিকা হিসেবে বর্ণনা করে, কনটেক্সট ও আউটপুট সীমাসহ। এর পাশে একটি মডেলের জন্য GET /v1/models/{model} এবং GET /v1/capabilities রয়েছে। চ্যাট নিজেই যায় POST /v1/chat/completions (OpenAI-সামঞ্জস্যপূর্ণ) বা POST /v1/messages (Anthropic-সামঞ্জস্যপূর্ণ) দিয়ে।

কেন একই মডেলের id সর্বত্র আলাদা#

ধরুন আপনি অন্য একটি প্রোভাইডারের টিউটোরিয়াল পেয়েছেন। সেটি model: "deepseek-chat" ব্যবহার করে, আপনি এটি CheapTokens বেস URL-এর পাশে পেস্ট করেন, এবং রিকোয়েস্ট ব্যর্থ হয়। আপনার কী-তে কোনো সমস্যা নেই। প্রোভাইডাররা একই মডেলের নাম ভিন্নভাবে দেয়: deepseek-ai/-এর মতো প্রিফিক্স, -0731-এর মতো ভার্সন সাফিক্স, ভিন্ন ক্যাপিটালাইজেশন। API শুধু সেই সঠিক স্ট্রিং গ্রহণ করে যা সে তালিকায় দেয়, এবং প্রাইস লেবেল থেকে নেওয়া সংক্ষিপ্ত নামও কাজ করবে না।

id একবার খুঁজে নেওয়ার পুরো কারণ এটাই। স্ক্রিনে ভুল id কেমন দেখায় তার সম্পূর্ণ বিবরণ চাইলে, API 401 or 404 error: wrong key, base URL or model id সেটি ধরে ধরে দেখায়। এই গাইডটি তার আগের ধাপ: সঠিক id খুঁজুন যাতে সেই এরর কখনো না দেখেন।

API-কে জিজ্ঞাসা করুন: একটি রিকোয়েস্ট#

আপনি যে ট্যাব ব্যবহার করেন সেটি বেছে নিন। দুটোই একই রিকোয়েস্ট পাঠায়। উভয় উদাহরণে কী আসে CHEAPTOKENS_API_KEY এনভায়রনমেন্ট ভেরিয়েবল থেকে (ব্যালেন্সে ফান্ড থাকলে কী-টি dashboard-এ থাকে)।

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

Python সংস্করণটি ইচ্ছাকৃতভাবে কাঁচা JSON প্রিন্ট করে। এটি একবার নিজের চোখে পড়ুন: আপনি মডেল id-গুলো এবং তাদের পাশে কনটেক্সট ও আউটপুট সীমা খুঁজছেন। প্রিন্টআউট থেকে প্রতিটি id সম্পূর্ণভাবে কপি করুন।

তিনটি id এবং তাদের সীমা#

ডকুমেন্টেশন এই কলযোগ্য মডেলগুলো তালিকাভুক্ত করে (২৮ অক্টোবর ২০২৬-এ যাচাইকৃত)। প্রতিটি লাইনের শুরুতে কোড ফরম্যাটিং-এ স্ট্রিংটি model হিসেবে পাঠান:

• zai-org/GLM-5.3-Flash — 390K কনটেক্সট, সর্বোচ্চ 8,192 আউটপুট টোকেন।
• deepseek-ai/DeepSeek-V4-Flash-0731 — 380K কনটেক্সট, সর্বোচ্চ 32,768 আউটপুট টোকেন।
• MiniMaxAI/MiniMax-M2.7 — 180K কনটেক্সট, সর্বোচ্চ 8,192 আউটপুট টোকেন।

বেশিরভাগ সিদ্ধান্তের জন্য দুটি সংখ্যা গুরুত্বপূর্ণ। কনটেক্সট হলো একটি রিকোয়েস্টে মডেল কতটা ধরে রাখতে পারে, আপনার প্রম্পট ও তার উত্তর একসাথে। আউটপুট সীমা হলো দীর্ঘতম একক উত্তর। এই শব্দগুলো নতুন হলে, how to read AI model names এবং why an answer stops mid-sentence সেগুলো সহজ ভাষায় ব্যাখ্যা করে।

আপনার কাজের জন্য একটি প্রথম মডেল বেছে নিন#

শুরু করতে দীর্ঘ বেঞ্চমার্ক গবেষণার দরকার নেই। দুটি প্রশ্ন বেশিরভাগ প্রথম পছন্দ ঠিক করে দেয়: আপনার ইনপুট কত বড়, এবং উত্তরটি কত দীর্ঘ হতে হবে? আপনার সবচেয়ে কাছের কেসটিতে ক্লিক করুন।

তিনটিই একটি ব্যালেন্স এবং দিনের যেকোনো সময় একই দাম শেয়ার করে, পিক আওয়ার নেই, তাই পরে বদলালে শুধু একটি স্ট্রিং পরিবর্তনের খরচ হয়। OpenRouter-এর তুলনায়, তিনটির প্রত্যেকটিই মোটে সস্তা, ইনপুট ও আউটপুট একসাথে গণনা করে। একটি ওয়ার্কলোড কেমন দেখায়: ধরুন আপনি একটি ছোট অ্যাসিস্ট্যান্ট চালান যা দিনে ১,০০০ বার ২,০০০ ইনপুট টোকেন পাঠায় এবং ৫০০ ফেরত পায়। নিচের লাইভ টেবিল ঠিক সেটিরই দাম দেয়।

প্রতিটি মডেলের বর্তমান প্রতি-টোকেন দাম pricing page-এ আছে, এবং model pages প্রতিটির উপর আরও গভীরে যায়। কাজ অনুযায়ী পাশাপাশি তুলনা চাইলে, GLM vs DeepSeek vs MiniMax: which model to choose আছে।

সীমা থেকে max_tokens সেট করুন, তারপর রিকোয়েস্ট পাঠান#

একটি সাধারণ ভুল: আপনি এমন একটি মডেল থেকে দীর্ঘ রিপোর্ট চান যার সীমা 8,192, এবং উত্তর অর্ধেকেই থেমে যায়। তালিকায় যে সীমা দেখেছেন সেটিই max_tokens-এর সর্বোচ্চ সীমা। এর সমান বা নিচে থাকুন।

তালিকা থেকে সম্পূর্ণ id দিয়ে একটি রিকোয়েস্ট এখানে। এটি সেই মডেল থেকে দীর্ঘ উত্তর চায় যা তা অনুমোদন করে:

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": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

প্রথম কল নতুন? Your first API request with CheapTokens উত্তর ফরম্যাট এবং usage ফিল্ড কভার করে।

রুটিনটি পাকা করতে, ধাপগুলো ক্রমে সাজান:

রিকোয়েস্ট এখনও ব্যর্থ হলে#

স্ট্রিং দিয়ে শুরু করুন। এক অক্ষরে ভিন্ন একটি মডেল id সাধারণত 404-এর কারণ, তাই আবার টাইপ না করে তালিকা থেকে আবার পেস্ট করুন। 402 মানে ব্যালেন্স শেষ, এবং রেট লিমিট প্রতি API কী-তে প্রতি মিনিটে 120 রিকোয়েস্ট। এররগুলো স্ট্যান্ডার্ড OpenAI/Anthropic JSON আকারে ফেরত আসে, তাই SDK-গুলো সেগুলো যথারীতি পার্স করে। সম্পূর্ণ ওয়াকথ্রুর জন্য, API 401 or 404 error দেখুন।

API https://api.cheaptokens.dev/v1-এ OpenAI- ও Anthropic-সামঞ্জস্যপূর্ণ; Anthropic SDK এবং Claude Code /v1 ছাড়া রুট URL https://api.cheaptokens.dev ব্যবহার করে। আরও সেটআপ বিবরণ docs-এ আছে।