OpenAI-compatible API: base_url کیا ہے اور سوئچ کیسے کریں

ایک OpenAI-compatible API ایسی API ہے جو درخواستیں OpenAI کی Chat Completions API کی طرح کے فارمیٹ میں وصول کرتی ہے اور اسی فارمیٹ میں جواب دیتی ہے۔ کسی ایپ کو دوسرے provider پر منتقل کرنے کے لیے آپ عام طور پر تین ویلیوز بدلتے ہیں: base_url (جہاں درخواستیں جاتی ہیں)، API key، اور model id۔ آپ کے باقی کوڈ، بشمول message list اور جواب پڑھنے کا طریقہ، ویسے ہی رہتے ہیں۔

یہ گائیڈ آسان الفاظ میں تصور کی وضاحت کرتی ہے اور Python اور curl میں CheapTokens پر پہلی کام کرنے والی درخواست پر ختم ہوتی ہے۔ CheapTokens کے بارے میں حقائق 22 اکتوبر 2026 کو اس کی دستاویزات سے جانچے گئے۔

"OpenAI-compatible" کا کیا مطلب ہے؟#

API انٹرنیٹ پر کسی سروس سے بات کرنے کے قواعد کا ایک مجموعہ ہے (اگر یہ لفظ نیا ہے تو آپ کی پہلی API درخواست کیسے کام کرتی ہے سے شروع کریں)۔ OpenAI کا chat فارمیٹ ایک عام معیار بن گیا: بہت سے providers اور ٹولز ایک ہی request body قبول کرتے ہیں اور ایک ہی response shape واپس کرتے ہیں۔ ایسی API کو OpenAI-compatible کہا جاتا ہے۔

عملی طور پر اس کا مطلب ہے کہ کسی بھی compatible provider پر تین چیزیں یکساں ہیں:

• درخواست: ایک JSON body جس میں model فیلڈ اور messages لسٹ ہوتی ہے، جہاں ہر message کا ایک role (system، user یا assistant) اور content ہوتا ہے۔
• Endpoint path: /chat/completions، جو base URL کے بعد شامل کیا جاتا ہے۔
• جواب: ایک JSON object جس میں تیار شدہ متن choices[0].message.content میں ہوتا ہے۔

چونکہ فارمیٹ مشترک ہے، سرکاری SDKs اور بہت سی ایپس کسی بھی compatible provider سے بات کر سکتی ہیں۔ انہیں صرف یہ جاننا ہوتا ہے کہ درخواست کہاں بھیجنی ہے۔

base_url کیا ہے؟#

base_url وہ پتہ ہے جس سے ہر درخواست شروع ہوتی ہے۔ SDK کال کا path اس میں شامل کر کے مکمل پتہ بناتا ہے۔

لہٰذا جب آپ مختلف base_url سیٹ کرتے ہیں، تو وہی کوڈ اسی قسم کی درخواست کسی مختلف سرور کو بھیجتا ہے۔ CheapTokens کا base URL https://api.cheaptokens.dev/v1 ہے۔ اس کی API OpenAI Chat Completions اور Anthropic Messages دونوں کے ساتھ compatible ہے، اور ایک prepaid balance تمام models کو پورا کرتا ہے۔

تین ویلیوز جو آپ بدلتے ہیں#

Model id توجہ کا مستحق ہے۔ مختلف providers ایک ہی model کو مختلف ids دیتے ہیں، اس لیے کسی دوسری سروس کی id یہاں کام نہیں کرے گی۔ ids CheapTokens دستاویزات سے لیں۔ اب دستیاب ids:

DeepSeek-V4-Flash فی جواب 32,768 tokens تک واپس کرتا ہے اور اس کا 380K context ہے؛ GLM-5.3-Flash کا 390K context ہے؛ MiniMax-M2.7 کا 180K context ہے۔ تینوں ایک ہی balance سے بل کیے جاتے ہیں، اس لیے ان کے درمیان سوئچ کرنے کا مطلب صرف model id بدلنا ہے۔

Python میں پہلی درخواست#

openai پیکیج انسٹال کریں، پھر اپنی key کوڈ میں لکھنے کے بجائے environment variable میں رکھیں:

pip install openai
export CHEAPTOKENS_API_KEY="YOUR_CHEAPTOKENS_KEY"

اب کوڈ۔ معیاری OpenAI مثال سے واحد فرق base_url آرگیومنٹ، key اور model id ہے:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",   # 1. where requests go
    api_key=os.environ["CHEAPTOKENS_API_KEY"],   # 2. your CheapTokens key
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",                # 3. model id from the docs
    messages=[
        {"role": "system", "content": "You answer briefly."},
        {"role": "user", "content": "Explain base_url in one sentence."},
    ],
)

print(response.choices[0].message.content)

مثال میں key ایک placeholder ہے: YOUR_CHEAPTOKENS_KEY کو اپنی key سے بدلیں اور کبھی بھی اصل key کسی repository میں commit نہ کریں۔

اگر آپ کی موجودہ ایپ config فائل یا environment variables سے settings پڑھتی ہے، تو آپ کو اس کا کوڈ بالکل ایڈٹ کرنے کی ضرورت نہیں۔ base URL، API base یا endpoint نامی فیلڈز تلاش کریں اور وہی تین ویلیوز وہاں بھریں۔

curl کے ساتھ وہی درخواست#

curl دکھاتا ہے کہ SDK پردے کے پیچھے کیا کرتا ہے: base URL کے ساتھ path، Authorization header میں key، اور ایک JSON body۔

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "Explain base_url in one sentence."}
    ]
  }'

آپ کو کیا نظر آنا چاہیے#

جب سب کچھ درست طریقے سے سیٹ ہو، تو Python اسکرپٹ ایک مختصر متنی جواب پرنٹ کرتا ہے، اور curl ایک JSON object پرنٹ کرتا ہے۔ choices لسٹ تلاش کریں: جواب کا متن choices[0].message.content میں ہے۔ اگر آپ کو یہ نظر آئے، تو CheapTokens پر آپ کی پہلی درخواست کام کر گئی، اور آپ اپنی اصل ایپ کی طرف بڑھ سکتے ہیں۔

اس کی لاگت کتنی ہے؟#

بلنگ tokens کے حساب سے ہوتی ہے، جو input اور output کے لیے الگ الگ گنے جاتے ہیں (دیکھیں input vs output tokens)۔ مثال کے طور پر، MiniMax-M2.7 کی موجودہ قیمت $0.05 فی 1M input tokens اور $0.15 فی 1M output tokens ہے۔ نیچے دیا گیا جدول ہمیشہ تمام models کی موجودہ قیمتیں دکھاتا ہے، بغیر peak-hour surcharges کے۔

تمام models کی مکمل فہرست کی قیمتیں CheapTokens pricing page پر بھی ہیں۔

اگر یہ کام نہ کرے#

• Authentication error (عام طور پر 401): key غائب ہے، غلط ٹائپ ہوئی ہے یا اس میں اضافی اسپیسز ہیں۔ چیک کریں کہ environment variable اسی ٹرمینل میں سیٹ ہے جہاں آپ اسکرپٹ چلاتے ہیں۔
• "Not found" (عام طور پر 404): base_url چیک کریں۔ اس کا اختتام /v1 پر ہونا چاہیے، اور SDK استعمال کرتے وقت آپ کو خود /chat/completions شامل نہیں کرنا چاہیے، ورنہ path دگنا ہو جائے گا۔
• Unknown model: model id اوپر دیے گئے جدول یا دستاویزات سے بالکل ویسے ہی کاپی کریں، بشمول بڑے حروف اور slash سے پہلے کا حصہ۔
• کوئی کنکشن نہیں یا timeout: دیکھیں عام کنکشن errors اور انہیں کیسے ٹھیک کریں۔
• جواب درمیان میں کٹ گیا: max_tokens حد تک پہنچ گئی، جس کا احاطہ AI جواب درمیان میں کیوں رک جاتا ہے میں کیا گیا ہے۔

اگلے مراحل#

ایک بار پہلی درخواست کام کرنے کے بعد، آپ Python میں streaming شامل کر سکتے ہیں، وہی تین ویلیوز اپنے editor یا agent میں ڈال سکتے ہیں، یا AI model کے نام کیسے پڑھیں پڑھ سکتے ہیں۔ سیٹ اپ کی تفصیلات اور models کی مکمل فہرست CheapTokens دستاویزات میں ہے۔