Hoppscotch میں CheapTokens کی پہلی درخواست: environment میں key

آپ اپنی پہلی CheapTokens درخواست Hoppscotch میں بغیر کچھ انسٹال کیے یا کوڈ لکھے بھیج سکتے ہیں: ویب ایپ کھولیں، base URL اور اپنی key ایک environment میں ڈالیں، ایک POST /chat/completions درخواست بنائیں، Send دبائیں۔ جواب اور token counts response panel میں نظر آئیں گے۔

صرف ایک چیز ہے جسے احتیاط سے کرنا چاہیے: key۔ اگر آپ اسے سیدھا درخواست میں پیسٹ کریں، تو یہ ہر screenshot اور ہر شیئر کیے گئے لنک میں آ جاتی ہے۔ environment variable اسے ایک ہی جگہ رکھتا ہے۔

یہ گائیڈ Hoppscotch کی سرکاری دستاویزات کی پیروی کرتی ہے (9 نومبر 2026 کو چیک کیا گیا؛ صفحات پر کوئی ورژن یا تاریخ نہیں ہے)۔ API کی طرف CheapTokens کا base URL https://api.cheaptokens.dev/v1 ہے، جو OpenAI Chat Completions فارمیٹ بولتا ہے۔ دونوں کے بارے میں مزید CheapTokens docs میں۔

base URL اور key کو environment میں ڈالیں#

Hoppscotch میں sidebar پر ایک Environments آئیکن ہے۔ اس پر کلک کریں، نیا environment بنائیں، اس کا نام cheaptokens رکھیں، اور دو variables شامل کریں:

دو types کیوں؟ Hoppscotch کی دستاویزات کے مطابق، ایک Regular variable ہر اس شخص کو نظر آتا ہے جو environment دیکھ سکتا ہے، جبکہ Secret والا masked رہتا ہے، کبھی sync یا share نہیں ہوتا، اور exports اور duplicates سے خارج رہتا ہے۔ key دوسری قسم میں آتی ہے: اسے variable کی value کے طور پر درج کریں۔ پھر cheaptokens environment منتخب کریں تاکہ درخواست اسے دیکھ سکے۔

درخواستوں میں، variable کو <<name>> کی طرح لکھا جاتا ہے: <<baseURL>> اور <<api_key>>۔ بس یہی پوری ترکیب ہے۔

درخواست بنائیں#

Hoppscotch کھولنے پر REST فعال mode ہوتا ہے۔ تین چیزیں سیٹ کرنی ہیں۔

Method اور URL۔ dropdown میں POST منتخب کریں اور درج کریں:

<<baseURL>>/chat/completions

key۔ Hoppscotch کے Authorization tab میں Bearer type ہے اور یہ token کو درخواست میں Bearer <token> کے طور پر شامل کرتا ہے۔ دستاویزات نہیں بتاتیں کہ <<api_key>> اس token field کے اندر کام کرتا ہے یا نہیں، اس لیے محفوظ راستہ اختیار کریں: Headers tab کھولیں اور ایک header شامل کریں۔

Authorization: Bearer <<api_key>>

آپ variable کو کہیں ہاتھ سے تبدیل نہیں کرتے، اور اصل key اس درخواست میں کبھی ظاہر نہیں ہوتی جو آپ اسکرین پر دیکھتے ہیں۔

body۔ Body tab کھولیں، Content Type dropdown میں application/json منتخب کریں (دستاویزات اسے JSON فارمیٹ میں content کی type کے طور پر درج کرتی ہیں)، اور پیسٹ کریں:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    {"role": "user", "content": "Explain what a token is in one sentence."}
  ],
  "max_tokens": 200
}

مکمل id deepseek-ai/DeepSeek-V4-Flash-0731 استعمال کریں۔ price list کا مختصر نام API قبول نہیں کرے گا۔ DeepSeek-V4-Flash کا 380K context اور فی جواب زیادہ سے زیادہ 32,768 output tokens ہیں، اس لیے 200 ٹیسٹ کے لیے جان بوجھ کر چھوٹی cap ہے۔ کوئی دوسرا model چاہیے؟ اس ایک field کو zai-org/GLM-5.3-Flash میں بدلیں (390K context، زیادہ سے زیادہ 8,192 output tokens) اور دوبارہ بھیجیں۔

Send دبائیں اور جواب پڑھیں#

Send پر کلک کریں۔ response section status code، body، headers، cookies اور timing دکھاتا ہے۔ آپ کو 200 اور OpenAI chat completion فارمیٹ جیسا JSON body چاہیے۔ دو جگہیں اہم ہیں:

• choices[0].message.content model کا جواب ہے۔
• usage میں prompt_tokens (جو آپ نے بھیجا) اور completion_tokens (جو model نے لکھا) ہیں۔ آپ سے اسی کی billed ہوتی ہے، اس لیے یہیں آپ چیک کرتے ہیں کہ درخواست کی لاگت توقع کے مطابق تھی۔

choices[0].finish_reason بھی دیکھیں۔ stop کا مطلب ہے کہ model خود ختم ہوا۔ length کا مطلب ہے کہ آپ کی max_tokens نے جواب کاٹ دیا۔ اگر ایک جملے کے سوال پر یہ نظر آئے، تو cap بہت کم ہے۔ مزید وضاحت AI answer cut off? Fix finish_reason "length" میں ہے۔

درخواست کو collection میں محفوظ کریں تو یہ دوبارہ قابل استعمال ہو جاتی ہے: message بدلیں، دوبارہ Send دبائیں۔

ایک ٹیسٹ درخواست کی لاگت#

ایک مختصر سوال اور مختصر جواب لیں: فرض کریں 30 tokens in اور 150 out۔ ایسی ایک درخواست کی لاگت $0.000015 ہے، اور نیچے live table ان میں سے 100 کو input اور output ملا کر گنتا ہے، OpenRouter کے ساتھ۔

مجموعی طور پر، input اور output ملا کر، یہ اسی model کے لیے OpenRouter سے سستا ہے۔ آپ کے اپنے اعداد مختلف ہوں گے، اس لیے اپنے کیس پر sliders گھسیٹیں:

قیمتیں فی model مقرر ہیں، کوئی peak-hour pricing نہیں، اور ایک balance تمام models کو cover کرتا ہے۔ موجودہ rates pricing page پر ہیں۔

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

REST client میں پہلی درخواست کی زیادہ تر ناکامیاں تین fields سے آتی ہیں۔ علامت کو وجہ سے ملائیں:

پہلی دو کے لیے مکمل walk-through API 401 or 404 error: wrong key, base URL or model id میں ہے۔ اگر آپ کو یقین نہیں کہ کون سا id استعمال کرنا ہے، تو list models with GET /v1/models۔

آگے کہاں جائیں#

یہی درخواست دوسرے clients میں بھی کام کرتی ہے: Postman version یا VS Code .http file دیکھیں۔ اگر آپ keys کو files اور shells سے بالکل باہر رکھنا چاہتے ہیں، تو store an API key safely بنیادی باتیں بتاتا ہے۔ Model ids اور OpenAI-compatible endpoint کی وضاحت docs میں ہے۔