بلاگ پر واپس جائیں

ٹولز اور انٹیگریشنزگائیڈ

DeepSeek Harness کو CheapTokens سے جوڑیں: کسٹم پرووائیڈر

DeepSeek Harness میں ایک کسٹم OpenAI-compatible پرووائیڈر شامل کریں، اسے CheapTokens API کی طرف اشارہ کریں اور پہلا کوڈنگ کام چلائیں۔ نیز ناکامی پر کیا چیک کریں۔

از CheapTokens Teamشائع شدہ 7 منٹ کا مطالعہ

کور: DeepSeek Harness ایک کسٹم پرووائیڈر کے ذریعے CheapTokens سے جڑا ہوا
اس صفحہ پر
  1. آپ کس سے جڑ رہے ہیں
  2. Harness کھولنے سے پہلے کلید چیک کریں
  3. کسٹم پرووائیڈر فارم بھریں
  4. ماڈل منتخب کریں اور پہلا کام چلائیں
  5. سستا ماڈل ایجنٹ لوپ کے لیے کیوں موزوں ہے
  6. اگر یہ کام نہ کرے
  7. ٹیب بند کرنے سے پہلے

DeepSeek Harness کو CheapTokens کے ساتھ استعمال کرنے کے لیے، Settings → Models کھولیں، کارڈ کو Custom model API پر سوئچ کریں، base URL کو https://api.cheaptokens.dev/v1 پر سیٹ کریں، پروٹوکول کے طور پر OpenAI Chat Completions منتخب کریں، اپنی CheapTokens کلید پیسٹ کریں اور ماڈل آئی ڈی deepseek-ai/DeepSeek-V4-Flash-0731 شامل کریں۔ پکر میں وہ ماڈل منتخب کریں اور آپ کا اگلا سیشن اسی پر چلے گا۔

یہی پورا ٹرک ہے۔ اس صفحے کا باقی حصہ درست فارم، ایپ کو قصوروار ٹھہرانے سے پہلے کلید کے کام کرنے کی فوری جانچ، اور ان چیزوں کی مختصر فہرست ہے جنہیں دیکھنا ہے جب گیٹ وے انکار کرے۔

نیچے دی گئی سیٹنگز 24 اکتوبر 2026 تک Harness دستاویزات سے لی گئی ہیں۔ یہ پروجیکٹ عوامی پیش نظارے میں ہے، اور اس کا README خبردار کرتا ہے کہ مطابقت توڑنے والی تبدیلیاں ہوں گی، لہذا اگر کوئی لیبل ہل گیا ہو تو اسکرین اور provider guide پر بھروسہ کریں۔

آپ کس سے جڑ رہے ہیں#

DeepSeek Harness DeepSeek کا ایک اوپن سورس ایجنٹ ہے (MIT لائسنس، Cordis پلگ ان آرکیٹیکچر پر بنایا گیا)۔ یہ Apple silicon پر macOS اور Windows 64-bit کے لیے ڈیسک ٹاپ ایپ کے طور پر، یا ویب UI کے طور پر آتا ہے جسے آپ npx @deepseek-ai/dsh web سے شروع کرتے ہیں (Node.js درکار)۔ ویب UI بطور ڈیفالٹ http://127.0.0.1:3080 پر کھلتا ہے۔

باکس سے باہر یہ DeepSeek کلید مانگتا ہے۔ لیکن اسی Models اسکرین میں ایک کارڈ ہے ہر اس چیز کے لیے جو اس کے کیٹلاگ میں نہیں، کوئی ریلے، کمپنی گیٹ وے یا کوئی اور پرووائیڈر۔ ہم وہی کارڈ استعمال کرتے ہیں۔

CheapTokens کی طرف آپ کو دو چیزیں چاہیے: ایک کلید اور ایک بیلنس۔ اگر آپ نے ابھی تک کلید نہیں بنائی تو Your first API request with CheapTokens میں چند منٹ لگتے ہیں، اور What is an API key and how to store it safely میں بتایا گیا ہے کہ اسے کہاں رکھنا ہے۔

Harness کھولنے سے پہلے کلید چیک کریں#

ٹرمینل سے ایک درخواست بتاتی ہے کہ کلید، بیلنس اور ماڈل آئی ڈی ٹھیک ہیں یا نہیں۔ اگر یہ کام کرتا ہے اور Harness نہیں، تو مسئلہ فارم میں ہے، اکاؤنٹ میں نہیں۔

bash
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 hi in five words."}]
  }'

آپ کو choices صف اور usage بلاک کے ساتھ JSON جواب ملنا چاہیے جو ان پٹ اور آؤٹ پٹ ٹوکنز گنتا ہے۔ Invalid API key طرز کی خرابی کا مطلب کلید ہے؛ بیلنس کے بارے میں پیغام کا مطلب ٹاپ اپ ضروری ہے۔

کسٹم پرووائیڈر فارم بھریں#

Settings → Models کھولیں اور پرووائیڈر کارڈ کو Custom model API پر سوئچ کریں۔ فیلڈز اس طرح بھریں:

فیلڈ کیا درج کریں
Provider ID cheaptokens (چھوٹے حروف؛ بعد میں تبدیل نہیں ہو سکتا، لہذا اپنی پسند کا نام چنیں)
Display name CheapTokens
Base URL https://api.cheaptokens.dev/v1
API protocol OpenAI Chat Completions
Credential آپ کی CheapTokens API کلید
Models deepseek-ai/DeepSeek-V4-Flash-0731

دو تفصیلیں لوگوں کو پریشان کرتی ہیں۔ پہلی، base URL https://api.cheaptokens.dev/v1 ہے، بالکل اوپر والے curl کی طرح سوائے /chat/completions کے۔ دوسری، ماڈل آئی ڈی deepseek-ai/ سابقے کے ساتھ مکمل ہے۔ deepseek-v4-flash جیسا مختصر نام وہ نہیں جو API توقع کرتا ہے۔ اگر آپ base_url کی پس منظر اور اسے کیسے سوئچ کرنا ہے جاننا چاہتے ہیں تو OpenAI-compatible API: what base_url is and how to switch دیکھیں۔

ایک Fetch available models بٹن بھی ہے۔ دستاویزات کہتی ہیں کہ یہ GET /models سے استفسار کرتا ہے اور آپ ہمیشہ آئی ڈی ہاتھ سے ٹائپ کر سکتے ہیں۔ یہاں ٹائپ کرنا محفوظ راستہ ہے، لہذا وہی کریں۔

Custom model API card in DeepSeek Harness: empty form turns into the filled CheapTokens provider
Illustration: the Custom model API card before and after filling it in

ماڈل منتخب کریں اور پہلا کام چلائیں#

ماڈل پکر کھولیں اور CheapTokens ماڈل منتخب کریں۔ وہاں ماڈل منتخب کرنے سے یہ نئے سیشنز کے لیے ڈیفالٹ ہو جاتا ہے، لہذا آپ کو اسے دہرانا نہیں پڑے گا۔

اب اسے کچھ چھوٹا اور قابل جانچ دیں۔ فرض کریں آپ کا ایک پروجیکٹ ہے جس میں ایک ٹیسٹ فیل ہو رہا ہے:

text
Run the tests, find why test_parse_date fails and fix it. Show me the diff.

آپ کیا دیکھنا چاہتے ہیں: ایجنٹ ٹیسٹ کمانڈ چلاتا ہے، فیل ہونے والی فائل پڑھتا ہے، اسے ایڈٹ کرتا ہے، ٹیسٹ دوبارہ چلاتا ہے اور ایک diff دکھاتا ہے۔ اگر یہ کرتا ہے تو کنکشن مکمل ہے۔ آپ کا بیلنس اب اس لوپ کی ادائیگی کرتا ہے۔

سستا ماڈل ایجنٹ لوپ کے لیے کیوں موزوں ہے#

ایجنٹ ایک سوال نہیں بھیجتا۔ یہ ہر قدم پر پوری گفتگو، فائل لسٹنگز اور ٹول آؤٹ پٹ دوبارہ بھیجتا ہے، لہذا سیشن زیادہ تر ان پٹ ٹوکنز پر مشتمل ہوتا ہے۔ یہی چیز ایجنٹ بلوں کو حیران کن بناتی ہے (why a long chat costs more میکانکس بتاتا ہے، اور How to estimate the cost of an AI agent طریقہ دیتا ہے)۔

فرض کریں ایک سیشن میں 200 مراحل ہیں، ہر مرحلہ تقریباً 30,000 ٹوکنز کا سیاق بھیجتا ہے اور تقریباً 600 ٹوکنز واپس لیتا ہے۔ یہ 200 × 30,000 = 6,000,000 ان پٹ ٹوکنز اور 200 × 600 = 120,000 آؤٹ پٹ ٹوکنز ہیں۔ DeepSeek-V4-Flash پر وہ سیشن آج کی قیمتوں پر $0.102 لاگت کرتا ہے، اور مجموعی طور پر یہ OpenRouter سے سستا ہے، ان پٹ اور آؤٹ پٹ دونوں ملا کر۔ نیچے دی گئی جدول ہر اس ماڈل کے لیے ایک ہی کام کا بوجھ استعمال کرتی ہے جو ہم پیش کرتے ہیں:

ماڈل لاگت OpenRouter
GLM-5.3-Flash $0.125 $0.257
DeepSeek-V4-Flash $0.102 $0.304
MiniMax-M2.7 $0.318 $1.94

کل 6,000,000 ان پٹ اور 120,000 آؤٹ پٹ ٹوکنز۔ فی 1M ٹوکنز کی قیمتیں موجودہ ہیں اور ہمارے ٹیرف کے ساتھ تبدیل ہوتی ہیں؛ OpenRouter کالم اسی ورک لوڈ کے لیے حوالہ جاتی قیمتیں دکھاتا ہے۔

طویل سیشنز کے لیے DeepSeek-V4-Flash آپ کو 380K سیاق ونڈو، ایک جواب میں 32,768 ٹوکنز تک، اور کسی بھی گھنٹے ایک ہی قیمت دیتا ہے: کوئی پیک آور سرچارج نہیں۔ یہ ہر دوسرے CheapTokens ماڈل کی طرح ایک ہی بیلنس استعمال کرتا ہے، لہذا آپ دوبارہ ٹاپ اپ کیے بغیر Harness میں ماڈلز سوئچ کر سکتے ہیں۔ موجودہ ریٹس pricing page پر ہیں، اور model page پر DeepSeek لائن کے بارے میں مزید ہے۔

سیشن ہلکا رکھنا پسند کریں؟ اسی پرووائیڈر میں اضافی ماڈل آئی ڈیز کے طور پر zai-org/GLM-5.3-Flash (390K سیاق، 8,192 آؤٹ پٹ ٹوکنز تک) یا MiniMaxAI/MiniMax-M2.7 (180K سیاق، 8,192 آؤٹ پٹ ٹوکنز تک) شامل کریں۔ ایک پرووائیڈر کئی ماڈلز رکھ سکتا ہے، اور پکر آپ کو ان کے درمیان منتقل ہونے دیتا ہے۔

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

Harness دستاویزات معمول کے مشتبہ افراد کی فہرست دیتی ہیں۔ یہاں وہ ہیں اور کیا کرنا ہے:

  • گیٹ وے ہر درخواست سے انکار کرتا ہے حالانکہ کلید اور URL درست ہیں۔ درخواست کی شکل اس سے مختلف ہے جس کی اینڈ پوائنٹ توقع کرتا ہے۔ Harness میں فی ماڈل مطابقت کی سیٹنگز ہیں، جیسے سسٹم پرامپٹ کے لیے استعمال ہونے والا رول یا آؤٹ پٹ ٹوکن فیلڈ کا نام۔ وہ $DSH_HOME/profiles/<profile>/cordis.patch.yml میں رہتی ہیں اور بغیر ری اسٹارٹ کے دوبارہ لوڈ ہوتی ہیں۔ درست کیز provider guide سے لیں بجائے اندازہ لگانے کے۔
  • آپ کے ٹائپ کردہ ماڈل کے لیے effort مینو غائب ہے۔ Harness صرف ان ماڈلز کے لیے استدلال کی سطحیں دکھاتا ہے جو ان کا اعلان کرتے ہیں۔ ہاتھ سے درج کردہ ماڈل میں کوئی اعلان نہیں ہوتا، لہذا مینو خالی رہتا ہے۔ سطحوں کا اعلان اسی فی ماڈل سیٹنگز فائل کا حصہ ہے۔
  • ماڈلز لاتے وقت 401۔ کلید چیک کریں، یا بٹن چھوڑ دیں اور ماڈل آئی ڈی خود درج کریں۔
  • جواب درمیان میں رک جاتا ہے۔ یہ ٹوکن کی حد ہے، ٹوٹا ہوا کنکشن نہیں؛ why an AI answer stops mid-sentence دیکھیں۔
  • پہلی درخواست سے لاگ میں 401 یا 403۔ اوپر والا curl چیک اسی کلید کے ساتھ دہرائیں۔ اگر curl کام کرتا ہے تو Credential فیلڈ میں کلید دوبارہ ٹائپ کریں؛ آخر میں ایک اضافی اسپیس کلاسک ہے۔

اگر آپ پہلے سے اسی کلید کے ساتھ کوئی اور ایجنٹ استعمال کرتے ہیں تو connecting OpenCode اسی پیٹرن کی پیروی کرتا ہے، اور CheapTokens docs ہر اینڈ پوائنٹ کی فہرست دیتے ہیں۔ اسی دراز میں ایک اور ٹول، ایک بیلنس۔

ٹیب بند کرنے سے پہلے#

  • Base URL: https://api.cheaptokens.dev/v1
  • Protocol: OpenAI Chat Completions
  • Model id: deepseek-ai/DeepSeek-V4-Flash-0731
  • Key: آپ کے CheapTokens اکاؤنٹ سے، اسکرین شاٹس اور ریپوز سے دور رکھیں

فیل ہونے والے ٹیسٹ کا کام ایک بار چلائیں اور اپنے بیلنس پر استعمال دیکھیں۔ وہ ایک رن بتاتا ہے کہ آپ کے اپنے سیشنز کی کتنی لاگت آتی ہے۔