RouterHub کیا فراہم کرتا ہے
RouterHub کو OpenRouter کے متبادل کے طور پر پیش کیا گیا ہے، جس میں ایک فعال ماڈل کیٹلاگ اور API تک رسائی کا طریقۂ کار شامل ہے۔ یہ ریپوزٹری ماڈل کی دریافت، API کے استعمال، منتقلی، قیمتوں، مختلف صورتوں، استعمال کے معاملات، حفاظت اور خرابیوں کے ازالے پر مشتمل دستاویزی مرکز کے طور پر کام کرتی ہے۔
دستاویزات کو مرکوز رہنماؤں کی ایک ترتیب کے طور پر منظم کیا گیا ہے۔ آپ انہیں شروع سے آخر تک پڑھ سکتے ہیں یا اپنے کام سے متعلق موضوع پر براہِ راست جا سکتے ہیں۔
صحیح نقطۂ آغاز منتخب کریں
- سروس کا جائزہ لینا: OpenRouter کا متبادل کیا ہے؟ اور RouterHub بمقابلہ OpenRouter سے شروع کریں۔
- منتقلی کی منصوبہ بندی: دستاویزی base URL، API key اور model-mapping کے عمل کے لیے منتقلی کی رہنما پڑھیں۔
- ماڈل تلاش کرنا: خاندانوں، IDs اور پروٹوکولز کا جائزہ لینے کے لیے ماڈل کیٹلاگ رہنما اور فعال کیٹلاگ استعمال کریں۔
- اپنی پہلی درخواست بھیجنا: API کوئیک اسٹارٹ پر عمل کریں۔
- اخراجات جانچنا: فی ٹوکن مثالوں کے لیے قیمتیں دیکھیں۔
- مختلف صورتوں کا موازنہ کرنا: غیر سینسر شدہ اور abliterated رہنما دیکھیں۔
رسائی ترتیب دیں
- RouterHub رجسٹریشن صفحہ کھولیں اور API key حاصل کرنے کے لیے آن بورڈنگ کے مراحل مکمل کریں۔
- اپنی ایپلیکیشن کے لیے درست model ID اور معاون پروٹوکول معلوم کرنے کی خاطر ماڈل کیٹلاگ کی دستاویزات دیکھیں۔
- اگر آپ موجودہ OpenRouter انضمام منتقل کر رہے ہیں تو دستاویزی base URL، key کے استعمال اور model mapping کے لیے منتقلی کی رہنما سے رجوع کریں۔
- پہلی درخواست تیار کرنے اور بھیجنے کے لیے API کوئیک اسٹارٹ استعمال کریں۔
اپنی API key کو خفیہ رکھیں۔ اسے براہِ راست source code میں رکھنے کے بجائے environment variable یا کسی دوسرے secret-management نظام میں محفوظ کریں۔
درست ماڈل تلاش کریں
ماڈل کا انتخاب RouterHub کے طریقۂ کار کا ایک اہم حصہ ہے۔ ریپوزٹری میں خاص طور پر ماڈل خاندانوں، model IDs اور پروٹوکولز کا احاطہ کرنے والی کیٹلاگ رہنما فراہم کی گئی ہے۔ کسی identifier کا اندازہ لگانے کے بجائے اس رہنما کو فعال ماڈل کیٹلاگ کے ساتھ استعمال کریں۔
عملی انتخاب کا طریقہ کچھ یوں ہے:
- کام متعین کریں، مثلاً coding، agent workflows، تحقیق یا تحریر۔
- دستیاب ماڈل خاندان اور variant کی معلومات دیکھیں۔
- کیٹلاگ میں دکھائی گئی درست model ID نقل کریں۔
- یقینی بنائیں کہ ماڈل کا پروٹوکول اس client یا integration سے مطابقت رکھتا ہے جسے آپ استعمال کرنے کا ارادہ رکھتے ہیں۔
- production traffic بھیجنے سے پہلے قیمتوں کی دستاویزات دیکھیں۔
پہلی API درخواست بھیجیں
ریپوزٹری پہلی درخواست کے لیے صارفین کو API کوئیک اسٹارٹ کی طرف رہنمائی کرتی ہے۔ چونکہ درست endpoint اور request format اسی رہنما میں برقرار رکھے جاتے ہیں، اس لیے کسی ثانوی مثال سے endpoint کو مستقل طور پر درج کرنے کے بجائے موجودہ اقدار وہیں سے استعمال کریں۔
آپ کی درخواست کی ترتیب کے لیے عموماً درج ذیل دستاویزی اقدار درکار ہوں گی:
API key: <your RouterHub API key>
Base URL: <value from the RouterHub API quickstart>
Model ID: <exact ID from the model catalogue>
Protocol: <protocol supported by the selected model>عملی implementation کے لیے API کوئیک اسٹارٹ کھولیں، اس کی request example نقل کریں، API key کو محفوظ طریقے سے درج کریں اور model value کو کیٹلاگ سے منتخب کردہ درست ID سے بدل دیں۔
موجودہ OpenRouter انضمام منتقل کریں
اگر آپ کی ایپلیکیشن پہلے ہی OpenRouter استعمال کرتی ہے تو ریپوزٹری کی منتقلی کی رہنما پر عمل کریں۔ README منتقلی کے تین امور کی نشاندہی کرتا ہے: base URL تبدیل کرنا، RouterHub API key استعمال کرنا اور model identifiers کی mapping کرنا۔
جانچ سے پہلے یہ فہرست استعمال کریں:
- منتقلی کی دستاویزات کے مطابق provider base URL اپ ڈیٹ کریں۔
- موجودہ credential کو RouterHub API key سے تبدیل کریں۔
- ہر model name کا جائزہ لے کر اسے درست RouterHub model ID سے map کریں۔
- منتخب ماڈل کے مطلوبہ پروٹوکول کی تصدیق کریں۔
- انضمام کو production میں منتقل کرنے سے پہلے ایک چھوٹی test request بھیجیں۔
منتقلی کی وجوہات کے وسیع تر پس منظر کے لیے منتقلی کیوں کریں پڑھیں، جس میں دستاویزات کے prepaid billing، model IDs اور غیر سینسر شدہ اختیارات کے موضوعات شامل ہیں۔
قیمتوں اور مختلف صورتوں کا جائزہ لیں
قیمتیں
قیمتیں رہنما فی ٹوکن مثالوں کی وضاحت کرتی ہے۔ اسے اپنے مطلوبہ workload کی لاگت کا اندازہ لگانے اور درخواستوں میں اضافہ کرنے سے پہلے ماڈلز کا موازنہ کرنے کے لیے استعمال کریں۔
غیر سینسر شدہ اور Abliterated ماڈلز
غیر سینسر شدہ اور abliterated رہنما ان variants کا موازنہ کرنے کے لیے ہے۔ ریپوزٹری کی حفاظت رہنما بھی پڑھیں اور ہر ماڈل کو قانونی اور ذمہ دارانہ طور پر استعمال کریں۔
عملی استعمال کے معاملات دیکھیں
پہلی درخواست کامیاب ہونے کے بعد استعمال کے معاملات رہنما coding، agents، تحقیق اور تحریر کا احاطہ کرتی ہے۔ ان مثالوں کو اپنے بنائے جانے والے application کی نوعیت کے مطابق ماڈل خاندان اور پروٹوکول منتخب کرنے کے لیے استعمال کریں۔
آپریشنل سوالات کے لیے خرابیوں کا ازالہ گائیڈ سے رجوع کریں۔ اس میں توثیق، ماڈل آئی ڈیز اور پروٹوکولز سے متعلق مسائل کو خاص طور پر حل کیا گیا ہے۔ اکثر پوچھے گئے سوالات تفصیلی جوابات فراہم کرتے ہیں، جبکہ لغت دستاویزات میں استعمال ہونے والی اصطلاحات کی وضاحت کرتی ہے۔
اعلیٰ درجے کی تجاویز
- درست آئی ڈیز کو ترجیح دیں: ناموں کے فرق سے پیدا ہونے والی ناکامیوں سے بچنے کے لیے ماڈل شناخت کنندگان کیٹلاگ سے نقل کریں۔
- پروٹوکولز پہلے جانچیں: ایپلیکیشن کوڈ کی ڈیبگنگ سے پہلے پروٹوکول کی مطابقت کی توثیق کریں۔
- ترتیب کوڈ سے الگ رکھیں: API key، base URL اور model ID کو قابلِ ترتیب رکھیں تاکہ منتقلی اور ٹیسٹنگ آسان ہو۔
- پہلے اخراجات کا اندازہ لگائیں: بڑے ورک لوڈز چلانے سے پہلے فی ٹوکن قیمتوں کی مثالیں استعمال کریں۔
- دستاویزات کے راستے استعمال کریں: ہر انضمامی مسئلے کو عمومی API مسئلہ سمجھنے کے بجائے منتقلی، فوری آغاز، قیمتوں یا خرابیوں کے ازالے کی گائیڈ منتخب کریں۔
- حفاظتی جائزہ لیں: غیر محدود یا ابلیٹیریٹڈ متغیرات کا جائزہ لیتے وقت حفاظتی رہنمائی پڑھیں اور استعمال کو قانونی مقاصد تک محدود رکھیں۔
نتیجہ
RouterHub ریپوزٹری OpenRouter کے متبادل کا جائزہ لینے اور اس کی API کے ساتھ انضمام کے لیے ایک منظم نقطۂ آغاز ہے۔ API key حاصل کر کے آغاز کریں، کیٹلاگ سے درست model ID منتخب کریں، پروٹوکول کی تصدیق کریں اور API کے فوری آغاز کی ہدایات پر عمل کریں۔ اگر آپ کسی موجودہ ایپلیکیشن کو منتقل کر رہے ہیں تو مخصوص منتقلی گائیڈ استعمال کریں، پھر تعیناتی سے پہلے قیمتوں، متغیرات، حفاظت اور خرابیوں کے ازالے سے متعلق امور کی توثیق کریں۔