ایک custom provider کے ساتھ Chatbox میں catalog کا ہر model شامل کریں۔

Updated 2026-07-29

Chatbox کسی بھی OpenAI-compatible endpoint کے لیے ایک Add Custom Provider flow ship کرتا ہے: OpenAI API Compatible mode چنیں، API Host کو https://api.apisrouter.com/v1 پر set کریں، ایک key paste کریں، اور Claude، GPT، Gemini، اور DeepSeek ids desktop، mobile، اور web پر model picker میں ساتھ ساتھ بیٹھ جاتی ہیں۔

فوری جواب: Model Provider settings میں ایک dialog۔

Chatbox کی Settings کھولیں اور Model Provider tab پر سوئچ کریں۔ Add کلک کریں، پھر Add Custom Provider۔ dialog کو پانچ values سے بھریں: ایک Name (APIsRouter)، API Mode جو OpenAI API Compatible پر set ہو، آپ کی key API Key میں، https://api.apisrouter.com/v1 API Host میں، اور API Path کو اس /chat/completions default پر چھوڑ دیں جو Chatbox /v1 پر ختم ہونے والے host کے لیے خود بھرتا ہے۔ پھر models شامل کریں۔ Fetch بٹن /v1/models کے ذریعے endpoint کی model list کھینچتا ہے تاکہ آپ catalog سے براہ راست ids enable کر سکیں، اور New آپ کو ہاتھ سے id ٹائپ کرنے دیتا ہے اگر آپ ایک مختصر curated picker چاہیں۔ key field کے ساتھ Check کلک کریں اور Chatbox ایک live request چلاتا ہے؛ ایک سبز confirmation کا مطلب ہے provider wired ہو گیا۔ ہم نے اس exact flow کو موجودہ Chatbox web app کے خلاف validate کیا ہے، اور وہی dialog desktop اور mobile builds میں بھی ship ہوتا ہے۔

Chatbox کسی custom provider سے کیسے بات کرتا ہے۔

Chatbox (GitHub پر chatboxai، تقریباً 41K stars) سب سے زیادہ install ہونے والے AI chat clients میں سے ایک ہے: Windows، macOS، اور Linux کے لیے native apps، iOS اور Android کے لیے mobile builds، اور web.chatboxai.app پر ایک browser version۔ یہ بڑے vendors کے لیے first-party entries کے ساتھ آتا ہے، ہر ایک اپنی key چاہتا ہے، اور custom provider dialog باقی سب کچھ کے لیے documented راستہ ہے۔ OpenAI API Compatible mode میں ایک custom provider ایک endpoint کی سادہ سی وضاحت ہے: host، path، key، اور model ids کی فہرست۔ ہر گفتگو کا turn اس host کے خلاف ایک معیاری chat-completions request بن جاتا ہے، picker کی model id ایک string کے طور پر سفر کرتی ہے۔ Chatbox کو پروا نہیں کہ کسی id کے پیچھے کس vendor نے model train کیا، جو بالکل وہی چیز ہے جو یہاں ایک multi-vendor gateway کو مفید بناتی ہے: ایک provider entry claude-sonnet-4-6، gpt-5.5، gemini-3.5-flash، اور deepseek-v4-flash کو ایک ہی picker میں لے آتی ہے، سب ایک ہی key پر bill ہوتے ہوئے۔ چار first-party providers stack کرنے سے عملی فرق صرف کم keys نہیں۔ Chatbox settings فی-device sync ہوتی ہیں، تو آپ جو بھی vendor account شامل کریں وہ ایک اور key ہے جو آپ کو اپنے phone، laptop، اور web app میں paste کرنی پڑتی ہے۔ ایک custom provider فی-device ایک paste ہے، اور کسی گفتگو کو Claude سے DeepSeek پر بدلنا provider تبدیلی کی بجائے صرف picker تبدیلی ہے۔

مکمل سیٹ اپ: dialog کی ہر field۔

Name صرف ایک label ہے؛ APIsRouter picker کو پڑھنے کے قابل رکھتا ہے۔ API Mode کو OpenAI API Compatible ہونا چاہیے، جو Chatbox کو معیاری chat completions بولنے کو کہتا ہے؛ dropdown میں دوسرا mode Gemini-native endpoints کے لیے ہے اور یہ وہ نہیں جو ایک gateway چاہتا ہے۔ API Host اور API Path مل کر request URL بناتے ہیں، اور یہی جوڑا وہ جگہ ہے جہاں setups غلط ہوتے ہیں۔ host کو https://api.apisrouter.com/v1 پر set کرنے سے، path /chat/completions ہو جاتی ہے، اور Chatbox بالکل وہی خود بھرتا ہے جب یہ /v1 والا host پہچانے۔ Chatbox docs bare-host convention بھی بیان کرتی ہیں، جہاں host /v1 چھوڑ دیتا ہے اور path default طور پر /v1/chat/completions ہو جاتی ہے؛ دونوں اسی URL پر compose ہوتی ہیں، تو ایک شکل چنیں اور دوسری field کو اس کے default پر چھوڑ دیں۔ جو چیز ٹوٹتی ہے وہ انہیں ملانا ہے، ایک /v1 host اور ایک /v1/chat/completions path، جو ایک دوگنی /v1/v1 URL بناتی ہے جو 404 دیتی ہے۔ Field labels اور autofill رویہ Chatbox releases کے درمیان تھوڑا بدلتے ہیں، تو یاد کی بجائے compose شدہ URL پر بھروسہ کریں۔ Models کے لیے، Fetch کم-محنت راستہ ہے: Chatbox وہ سب کچھ فہرست کرتا ہے جو endpoint سرو کرتا ہے اور آپ toggle کرتے ہیں جو چاہیں۔ New curated راستہ ہے: ہاتھ سے ids ٹائپ کریں اور picker مختصر رہتا ہے۔ ہر model row پر capability switches (vision، tool use) ہیں؛ انہیں off چھوڑیں جب تک آپ نہ جانیں کہ model اس capability کو سپورٹ کرتا ہے، چونکہ ایک unconfigured model plain text کے طور پر treat ہوتا ہے اور یہی محفوظ default ہے۔ Check کے ساتھ ختم کریں، پھر ایک گفتگو شروع کریں اور اپنے نئے provider نام کے تحت ایک model چنیں۔

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

روزمرہ chat client کے لیے models چننا۔

چونکہ ہر enabled model ایک ہی key پر bill ہوتا ہے، دو ids کا موازنہ account فیصلے کی بجائے picker switch ہے۔ چند دنوں کے لیے دونوں پر ایک جیسی گفتگوئیں چلائیں، پھر APIsRouter console میں فی-model spend پڑھیں اور جو کمائے اسے رکھیں۔

  • روزمرہ سوالات اور تیز rewrites burst کام ہیں۔ claude-haiku-4-5-20251001 اور gemini-3.5-flash اتنی تیزی سے جواب دیتے ہیں کہ app instant محسوس ہوتا ہے، اور یہ زیادہ تر روزمرہ traffic اچھی طرح اٹھاتے ہیں۔
  • لمبی drafting، careful reasoning، اور code گفتگوئیں claude-sonnet-4-6 یا gpt-5.5 کماتی ہیں۔ ہر tier سے ایک enabled رکھیں اور فی-provider کی بجائے فی-گفتگو سوئچ کریں۔
  • اگر Chatbox آپ کا ہمیشہ کھلا sidebar ہے تو deepseek-v4-flash volume انتخاب ہے؛ مستقل چھوٹی گفتگوئیں جمع ہوتی ہیں اور fast tier balance کو آہستہ چلتا رکھتی ہے۔
  • Image-input گفتگوؤں کو اس model row پر vision switch enabled کے ساتھ ایک vision-capable id چاہیے؛ switch flip کرنے سے پہلے model documentation کے خلاف capability confirm کریں۔
  • جان بوجھ کر کچھ models enable کریں، ہر چیز fetch کرنے کی بجائے: ہر toggle ایک picker row ہے، اور بعد میں ایک اور id شامل کرنا دس-سیکنڈ کا edit ہے۔

استعمال کے مطابق ادائیگی · سرکاری قیمت سے کم

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ماڈلسرکاری قیمتہماری قیمت
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M

Chatbox سے مخصوص failure modes۔

دوگنا path classic ہے۔ ہر message پر 404 کا مطلب ہے API Host اور API Path دونوں میں /v1 ہے یا path اسے دہراتی ہے جس پر host پہلے سے ختم ہوتا ہے؛ provider entry کھولیں اور دونوں fields کو ایک URL کے طور پر پڑھیں۔ Fetch سے خالی نتیجہ عموماً یہ ظاہر کرتا ہے کہ key غلط یا غائب ہے، چونکہ model listing خود ایک authenticated request ہے۔ API Key field چیک کریں اور Check بٹن استعمال کریں، جو authentication errors کو براہ راست ظاہر کرتا ہے۔ کوئی model جو صرف کچھ گفتگوؤں میں error دے عموماً ایک capability switch ہے: کسی ایسے model پر vision enabled جس میں image input نہیں، یا کوئی tool-dependent flow کسی ایسے model سے ٹکرا رہا ہے جس میں tools off ہیں۔ model row کو defaults پر reset کریں اور capabilities ایک ایک کر کے دوبارہ enable کریں۔ اور یاد رکھیں provider entry فی-installation رہتی ہے۔ اپنے desktop پر APIsRouter شامل کرنا آپ کے phone کو configure نہیں کرتا؛ dialog وہاں دہرائیں، یا اگر آپ کا version پیش کرے تو Chatbox کی اپنی config sharing استعمال کریں۔ ایک چیز جسے کبھی دہرانے کی ضرورت نہیں پڑتی وہ vendor sign-ups ہیں، چونکہ ایک key ہر device پر ہر model cover کرتی ہے۔

Chatbox کو gateway کے ذریعے کون route کرتا ہے۔

  • وہ لوگ جو ایک ہی picker میں Claude، GPT، Gemini، اور DeepSeek چاہتے ہیں بغیر تین devices میں چار vendor accounts اور چار keys سنبھالے۔
  • وہ regions کے users جہاں کچھ vendor sign-ups مشکل ہیں؛ top-up پر مبنی رسائی بغیر کارڈ کی شرط کے فی-provider انحصار ختم کر دیتی ہے۔
  • وہ developers جو پہلے سے اپنے editor اور terminal tools کو gateway کے ذریعے route کرتے ہیں اور اپنا chat client اسی key اور اسی usage log پر چاہتے ہیں۔
  • وہ model shoppers جو کسی project کو ایک پر commit کرنے سے پہلے حقیقی گفتگوؤں پر ids کا موازنہ کرتے ہیں؛ ہر candidate ایک picker row ہے، account نہیں۔
  • Households اور چھوٹی teams جو ایک endpoint، ایک balance، اور per-key usage visibility پر standardize کرتی ہیں، بکھری subscriptions کی بجائے۔

Endpoint verify کریں اور پہلا message debug کریں۔

پہلے Chatbox کے باہر gateway کا حصہ ثابت کریں: اپنی key کے ساتھ models فہرست کریں، پھر جس id کو آپ enable کرنے کا ارادہ رکھتے ہیں اس کے خلاف ایک chat completion چلائیں۔ اگر دونوں pass ہوں، تو باقی سب کچھ provider dialog میں ہے۔ Chatbox کے اندر، Check بٹن سب سے تیز اشارہ ہے۔ Authentication errors key field ہیں۔ Send پر Not-found errors ایک id mismatch ہیں، جو زیادہ تر ہاتھ سے ٹائپ کی گئی New entries کے ساتھ ہوتا ہے؛ یاد کی بجائے /v1/models output سے ids copy کریں۔ ہر request پر 404s اوپر بیان کردہ host/path composition ہیں۔ جب messages چلنے لگیں تو APIsRouter console فی-request model، token counts، اور spend دکھاتا ہے۔ ایک chat client دن بھر بہت ساری چھوٹی requests پیدا کرتا ہے، اور usage log وہ جگہ ہے جہاں وہ عادت فی-model، فی-day پڑھنے کے قابل نمبر بن جاتی ہے۔

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

عمومی سوالات

میں Chatbox میں custom API host کیسے شامل کروں؟

Settings، Model Provider tab، Add، پھر Add Custom Provider۔ API Mode کو OpenAI API Compatible پر، API Host کو https://api.apisrouter.com/v1 پر set کریں، اپنی key paste کریں، اور API Path کو اس کے /chat/completions default پر چھوڑ دیں۔ Fetch یا New کے ساتھ models شامل کریں، پھر Check دبائیں۔

کیا API Host میں /v1 شامل ہونا چاہیے؟

دونوں شکلیں کام کرتی ہیں جب تک host اور path بالکل ایک بار /v1/chat/completions پر compose ہوں۔ https://api.apisrouter.com/v1 والے host کے ساتھ path /chat/completions ہے؛ bare host کے ساتھ path default طور پر /v1/chat/completions ہے۔ دونوں کو ملانا /v1 کو دوگنا کر دیتا ہے اور 404 دیتا ہے۔

کیا Chatbox ایک provider entry کے ذریعے Claude، Gemini، اور DeepSeek چلا سکتا ہے؟

جی ہاں۔ OpenAI API Compatible mode میں model id API Host تک plain string کے طور پر سفر کرتی ہے، تو ایک entry claude-sonnet-4-6، gemini-3.5-flash، اور deepseek-v4-flash کو ساتھ enable کر سکتی ہے، سب ایک ہی key پر bill ہوتے ہوئے اور picker میں سوئچ کے قابل۔

Fetch کوئی model کیوں واپس نہیں کرتا؟

Fetch آپ کی key کے ساتھ endpoint کی /v1/models فہرست call کرتا ہے، تو ایک خالی نتیجہ تقریباً ہمیشہ authentication مسئلہ ہے۔ API Key field دوبارہ چیک کریں اور Check بٹن چلائیں؛ key pass ہونے کے بعد، Fetch gateway سرو کرنے والی ہر id فہرست کرتا ہے۔

کیا custom provider Chatbox mobile اور web پر بھی کام کرتا ہے؟

جی ہاں، Add Custom Provider dialog desktop، mobile، اور web builds میں ship ہوتا ہے۔ Provider entries فی-installation configure ہوتی ہیں، تو ایک ہی key کے ساتھ ہر device پر وہی ایک-dialog setup دہرائیں۔

کیا مجھے ہر model پر capability switches چاہئیں؟

نہیں۔ ایک unconfigured model plain text chat کے طور پر کام کرتا ہے، جو محفوظ default ہے۔ صرف ان models پر vision یا tool switches enable کریں جو واقعی capability سپورٹ کرتے ہیں، چونکہ غلط طور پر enabled switch بالکل انہی گفتگوؤں میں الجھانے والے errors پیدا کرتی ہے جو اسے استعمال کرتی ہیں۔