OpenHands کو CheapTokens سے جوڑیں: ماڈل، Base URL، کی

آپ Settings > LLM میں Advanced آن کرنے کے بعد تین فیلڈز بھر کر OpenHands کو CheapTokens ماڈل پر چلا سکتے ہیں: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731)، Base URL (https://api.cheaptokens.dev/v1)، اور API Key۔ بس اتنی ہی سیٹ اپ ہے۔ اس صفحے کا باقی حصہ بتاتا ہے کہ ہر فیلڈ کا مطلب کیا ہے اور جب کوئی غلط ہو تو کیسا دکھتا ہے۔

فیلڈ کے نام اور ماڈل-سٹرنگ کا اصول OpenHands کے دستاویزات کے صفحے سے آتے ہیں جو OpenAI-مطابق endpoints پر ہے (8 نومبر 2026 کو چیک کیا گیا؛ صفحے پر کوئی تاریخ یا ورژن نہیں ہے)۔ اس تاریخ پر OpenHands کا تازہ ترین ریلیز v1.37.0 (6 نومبر 2026) ہے۔ اگر آپ کے بلڈ میں کوئی لیبل تھوڑا مختلف دکھے تو پوزیشن سے جائیں: ماڈل، بیس URL، کی۔

Settings کھولنے سے پہلے#

تین چیزیں ہاتھ میں ہوں تو ایک چکر بچ جاتا ہے: کی، ماڈل آئی ڈی اور Settings تک رسائی۔

کیز اور بیس URLs میں نئے ہیں؟ What base_url is and how to switch چند منٹوں میں سمجھا دیتا ہے، اور list models with GET /v1/models دکھاتا ہے کہ خود آئی ڈی کیسے تلاش کریں۔

تین فیلڈز#

Settings > LLM کھولیں اور Advanced آن کریں۔ Base URL فیلڈ Advanced ٹوگل کے نیچے ہے۔

دستاویزات ماڈل کا اصول یوں بیان کرتے ہیں: Custom Model openai/ کے بعد ماڈل کا نام ہے، اور اگر آپ ایسے پراکسی سے گزریں جس کا اپنا سابقہ (prefix) ہو تو openai/<proxy-prefix>/<model-name>۔ openai/ کے بعد والا حصہ ماڈل کا نام ہے۔ CheapTokens کے لیے آئی ڈی deepseek-ai/DeepSeek-V4-Flash-0731 ہے، تو مکمل سٹرنگ openai/deepseek-ai/DeepSeek-V4-Flash-0731 ہے۔

ایجنٹ کے لیے یہ ماڈل کیوں؟ DeepSeek-V4-Flash کا 380K کا context window اور فی جواب 32,768 تک output tokens ہیں، اور ہر وقت ایک ہی قیمت ہے، تو لمبا سیشن مصروف وقت میں مہنگا نہیں ہوتا۔ کوڈنگ ایجنٹ ہر قدم پر بہت سا context دوبارہ بھیجتا ہے، اور window اسی کے لیے ہے۔

GLM پسند ہے؟ اسی فیلڈ میں openai/zai-org/GLM-5.3-Flash استعمال کریں (390K context، 8,192 تک output tokens) اور کچھ اور نہ بدلیں۔ وہی بیلنس، وہی کی، وہی Base URL۔

پہلے OpenHands سے باہر اجزاء چیک کریں#

ایجنٹ کو قصوروار ٹھہرانے سے پہلے، اسی URL، کی اور آئی ڈی کے ساتھ ایک درخواست بھیجیں۔ اگر یہ کام کرے تو باقی کوئی بھی مسئلہ فیلڈز ٹائپ کرنے کے طریقے میں ہے۔

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 ready"}],"max_tokens":20}'

غور کریں کہ کیا غائب ہے: model قدر میں کوئی openai/ نہیں ہے۔ وہ سابقہ OpenHands کے لیے ہے، API کے لیے نہیں۔ جواب میں usage بلاک ہوتا ہے جس میں prompt_tokens اور completion_tokens ہیں — وہی دو نمبر جو بعد میں ایجنٹ سیشن میں جمع ہوتے دکھیں گے۔

غلط فیلڈ کیسی دکھتی ہے#

تینوں فیلڈز میں سے کوئی بھی وجہ ہو سکتی ہے:

• غلط کی۔ API 401 جواب دیتا ہے — کی غائب ہے، غلط ٹائپ ہوئی ہے، یا کاپی کرتے وقت آخر میں اسپیس رہ گئی ہے۔
• غلط Base URL۔ درخواست غلط جگہ جاتی ہے اور آپ کو 404 یا کنکشن کی خرابی ملتی ہے۔ پتہ /v1 پر ختم ہونا چاہیے اور اس میں کوئی اضافی path نہیں ہونا چاہیے۔
• غلط ماڈل سٹرنگ۔ یا تو سابقہ غائب ہے، یا اس کے بعد کی آئی ڈی مکمل آئی ڈی نہیں (API صرف مکمل gateway_id قبول کرتا ہے، deepseek-v4-flash-0731 جیسی مختصر آئی ڈی نہیں)۔

401 بمقابلہ 404 کی پوری وجہ API 401 or 404: wrong key, base URL or model id میں ہے۔

ایک سیشن کی لاگت#

ایجنٹ ہر قدم پر پورے context کا بل لیتا ہے، آپ کے ایک سطری کام کا نہیں۔ فرض کریں OpenHands کسی بگ پر 40 قدم کام کرتا ہے، ہر قدم پر تقریباً 30,000 tokens بھیجے جاتے ہیں اور 1,500 واپس لکھے جاتے ہیں۔ DeepSeek-V4-Flash پر ایک قدم $0.0006 ہے؛ ان کے چالیس نیچے ہیں، دیگر ماڈلز اور OpenRouter کے ساتھ۔

مجموعی طور پر، input اور output ملا کر، اس کام کے لیے DeepSeek-V4-Flash OpenRouter سے سستا نکلتا ہے۔ مفروضے آپ بدل سکتے ہیں: چھوٹی مرمت میں 10 قدم لگ سکتے ہیں، بڑے refactor میں 100۔ موجودہ قیمتیں pricing page پر ہیں، اور ماڈل کا صفحہ cheap DeepSeek ہے۔

پہلے سے OpenHands کسی اور provider کے ساتھ استعمال کر رہے ہیں؟#

تو آپ صرف تین قدریں بدلتے ہیں: Custom Model، Base URL، API Key۔ پروجیکٹ میں کچھ اور نہیں بدلتا، اور آپ اسی طرح واپس بھی جا سکتے ہیں۔ API کے ساتھ قدم بہ قدم کنکشن CheapTokens docs میں ہے؛ کسی دوسرے ٹول میں ملتا جلتا سیٹ اپ connect Aider ہے۔