GET /v1/models سے ماڈلز کی فہرست بنا کر exact model id تلاش کریں

آپ کا کوڈ کسی ماڈل کے نام پر 404 واپس کرتا ہے جو کسی اور کی مثال میں ٹھیک لگ رہا تھا۔ API سے خود پوچھیں: https://api.cheaptokens.dev/v1/models پر ایک GET درخواست ان ماڈلز کی فہرست دیتی ہے جنہیں آپ کال کر سکتے ہیں، ان کے context اور output limits کے ساتھ۔ id اسی جواب سے کاپی کریں، یادداشت سے نہیں، اور max_tokens سیٹ کرنے سے پہلے limit چیک کریں۔

ڈاکس صفحہ (CheapTokens docs، 28 اکتوبر 2026 کو چیک کیا گیا) GET /v1/models کو قابلِ کال ماڈلز کی فہرست کے طور پر بیان کرتا ہے، context اور output limits کے ساتھ۔ اس کے ساتھ ایک ماڈل کے لیے GET /v1/models/{model} اور GET /v1/capabilities ہیں۔ چیٹ خود POST /v1/chat/completions (OpenAI-compatible) یا POST /v1/messages (Anthropic-compatible) کے ذریعے جاتی ہے۔

ایک ہی ماڈل کا id ہر جگہ مختلف کیوں ہوتا ہے#

فرض کریں آپ کو کسی دوسرے provider کے لیے ٹیوٹوریل ملا۔ اس میں model: "deepseek-chat" استعمال ہوتا ہے، آپ اسے CheapTokens base URL کے ساتھ پیسٹ کرتے ہیں، اور درخواست ناکام ہو جاتی ہے۔ آپ کی key میں کوئی خرابی نہیں۔ Providers ایک ہی ماڈل کو مختلف نام دیتے ہیں: deepseek-ai/ جیسا prefix، -0731 جیسا version suffix، مختلف capitalisation۔ API صرف وہی exact string قبول کرتا ہے جو وہ فہرست میں دیتا ہے، اور price label سے لی گئی مختصر نام بھی کام نہیں کرے گی۔

یہی وجہ ہے کہ id ایک بار تلاش کر لی جائے۔ اگر آپ جاننا چاہتے ہیں کہ غلط id اسکرین پر کیسا دکھتا ہے، تو API 401 or 404 error: wrong key, base URL or model id اس پر تفصیل سے بات کرتا ہے۔ یہ گائیڈ اس سے پہلے کا قدم ہے: صحیح id تلاش کریں تاکہ آپ کو وہ error کبھی نہ دیکھنا پڑے۔

API سے پوچھیں: ایک درخواست#

وہ ٹیب منتخب کریں جو آپ استعمال کرتے ہیں۔ دونوں ایک ہی درخواست بھیجتے ہیں۔ دونوں مثالوں میں key CHEAPTOKENS_API_KEY environment variable سے آتی ہے (key dashboard میں ہے جب balance پر funds ہوں)۔

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 ورژن جان بوجھ کر raw JSON پرنٹ کرتا ہے۔ اسے ایک بار اپنی آنکھوں سے پڑھیں: آپ model ids تلاش کر رہے ہیں اور ان کے ساتھ context اور output limits۔ ہر id پرنٹ آؤٹ سے مکمل کاپی کریں۔

تین ids اور ان کی limits#

ڈاکس یہ قابلِ کال ماڈلز بتاتے ہیں (28 اکتوبر 2026 کو چیک کیا گیا)۔ ہر سطر کے شروع میں code formatting میں string بھیجیں بطور model:

• zai-org/GLM-5.3-Flash — 390K context، زیادہ سے زیادہ 8,192 output tokens۔
• deepseek-ai/DeepSeek-V4-Flash-0731 — 380K context، زیادہ سے زیادہ 32,768 output tokens۔
• MiniMaxAI/MiniMax-M2.7 — 180K context، زیادہ سے زیادہ 8,192 output tokens۔

زیادہ تر فیصلوں کے لیے دو نمبر اہم ہیں۔ Context یہ ہے کہ ماڈل ایک درخواست میں کتنا رکھ سکتا ہے، آپ کا prompt اور اس کا جواب ملا کر۔ Output limit سب سے طویل واحد جواب ہے۔ اگر یہ الفاظ نئے ہیں، تو how to read AI model names اور why an answer stops mid-sentence انہیں آسان زبان میں سمجھاتے ہیں۔

اپنے کام کے لیے پہلا ماڈل منتخب کریں#

شروع کرنے کے لیے آپ کو طویل benchmark study کی ضرورت نہیں۔ دو سوالات زیادہ تر پہلے انتخاب طے کر دیتے ہیں: آپ کا input کتنا بڑا ہے، اور جواب کتنا طویل ہونا چاہیے؟ اپنے سے قریب ترین کیس پر کلک کریں۔

تینوں ایک ہی balance اور دن کے کسی بھی وقت ایک ہی قیمت شیئر کرتے ہیں، بغیر peak hours، تو بعد میں تبدیل کرنے پر صرف ایک string بدلنے کی لاگت آتی ہے۔ OpenRouter کے مقابلے میں، تینوں میں سے ہر ایک مجموعی طور پر سستا ہے، input اور output ملا کر گنے جاتے ہیں۔ ایک workload کی مثال: فرض کریں آپ ایک چھوٹا assistant چلاتے ہیں جو 2,000 input tokens بھیجتا ہے اور 500 واپس پاتا ہے، دن میں 1,000 بار۔ نیچے دیا گیا live table بالکل اسی کی قیمت لگاتا ہے۔

ہر ماڈل کی موجودہ per-token قیمتیں pricing page پر ہیں، اور model pages ہر ایک پر مزید گہرائی میں جاتے ہیں۔ اگر آپ کام کے لحاظ سے side-by-side موازنہ چاہتے ہیں، تو GLM vs DeepSeek vs MiniMax: which model to choose موجود ہے۔

limit سے max_tokens سیٹ کریں، پھر درخواست بھیجیں#

ایک عام غلطی: آپ ایسے ماڈل سے طویل رپورٹ مانگتے ہیں جس کی limit 8,192 ہے، اور جواب آدھے راستے میں رک جاتا ہے۔ فہرست میں جو limit آپ نے دیکھی وہ max_tokens کی ceiling ہے۔ اس پر یا اس سے نیچے رہیں۔

یہاں فہرست سے مکمل 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 جواب کی format اور usage field کور کرتا ہے۔

روٹین کو پکا کرنے کے لیے، مراحل کو ترتیب دیں:

اگر درخواست پھر بھی ناکام ہو#

string سے شروع کریں۔ ایک حرف کے فرق والا model id عام طور پر 404 کی وجہ ہوتا ہے، تو اسے دوبارہ ٹائپ کرنے کے بجائے فہرست سے دوبارہ پیسٹ کریں۔ 402 کا مطلب ہے balance ختم ہو گیا، اور rate limit فی API key 120 requests فی منٹ ہے۔ Errors معیاری OpenAI/Anthropic JSON شکل میں واپس آتے ہیں، تو SDKs انہیں معمول کے مطابق parse کرتے ہیں۔ مکمل walk-through کے لیے، API 401 or 404 error دیکھیں۔

API https://api.cheaptokens.dev/v1 پر OpenAI- اور Anthropic-compatible ہے؛ Anthropic SDKs اور Claude Code root URL https://api.cheaptokens.dev استعمال کرتے ہیں بغیر /v1 کے۔ مزید setup تفصیلات docs میں ہیں۔