شنو كيوفّر RouterHub
RouterHub كيتقدّم كبديل لـ OpenRouter، ومعاه كتالوغ حيّ ديال الموديلات ومسار للولوج للـ API. هاد المستودع هو مركز للتوثيق كيغطي اكتشاف الموديلات، استعمال الـ API، الترحيل، الأثمنة، النسخ، حالات الاستعمال، السلامة، وحلّ المشاكل.
التوثيق منظّم على شكل سلسلة ديال الأدلة المركّزة. تقدر تقراهم من اللول للآخر، ولا تمشي مباشرة للموضوع اللي كيناسب المهمة ديالك.
اختار نقطة البداية المناسبة
- إلى بغيتي تقيّم الخدمة: بدا بـ شنو هو بديل OpenRouter؟ وRouterHub مقابل OpenRouter.
- إلى كتخطّط للترحيل: قرا دليل الترحيل باش تعرف عنوان الـ base URL الموثّق، مفتاح الـ API، وطريقة ربط الموديلات.
- إلى كتقلب على موديل: استعمل دليل كتالوغ الموديلات والكتالوغ الحي باش تراجع العائلات، المعرّفات، والبروتوكولات.
- إلى بغيتي تدير أول طلب: تبع البداية السريعة ديال الـ API.
- إلى بغيتي تراجع التكاليف: شوف الأثمنة والأمثلة ديال الثمن لكل توكن.
- إلى بغيتي تقارن النسخ: شوف دليل الموديلات غير المراقبة والمجرّدة من القيود.
وجد الولوج
- حلّ صفحة التسجيل فـ RouterHub وتبع مراحل البداية باش تحصل على مفتاح API.
- راجع توثيق كتالوغ الموديلات باش تحدد المعرّف الدقيق ديال الموديل والبروتوكول اللي كيدعمو التطبيق ديالك.
- إلى كنت كترحّل ربط موجود مع OpenRouter، رجع لـ دليل الترحيل باش تعرف الـ base URL الموثّق، طريقة التعامل مع المفتاح، وربط الموديلات.
- استعمل البداية السريعة ديال الـ API باش تركّب وتبعث أول طلب.
خلي مفتاح الـ API ديالك سرّي. خزّنو فمتغيّر بيئة ولا فشي نظام آخر لتدبير الأسرار، وما تحطّوش مباشرة فالكود المصدري.
لقى الموديل الصحيح
اختيار الموديل جزء مهم من طريقة الخدمة ديال RouterHub. المستودع كيوفّر بالخصوص دليل للكتالوغ كيغطي عائلات الموديلات، معرّفات الموديلات، والبروتوكولات. استعمل هاد الدليل مع كتالوغ الموديلات الحيّ بلا ما تخمّن المعرّف.
عملية عملية للاختيار كتكون هكا:
- حدّد المهمة، بحال البرمجة، سيرورات الوكلاء، البحث، ولا الكتابة.
- تصفّح المعلومات المتوفرة على عائلات الموديلات والنسخ ديالها.
- نسخ المعرّف الدقيق ديال الموديل اللي باين فـ الكتالوغ.
- تأكّد باللي البروتوكول ديال الموديل مناسب للعميل ولا الربط اللي ناوي تستعمل.
- راجع توثيق الأثمنة قبل ما تبعث طلبات ديال الإنتاج.
دير أول طلب API
المستودع كيوجّه المستخدمين للبداية السريعة ديال الـ API باش يديرو أول طلب. حيث إن الـ endpoint بالضبط وصيغة الطلب كيتحافظ عليهم فداك الدليل، استعمل القيم الحالية ديالو وما تثبّتش endpoint جاي من مثال ثانوي.
إعداد الطلب ديالك غالباً غيحتاج للقيم الموثّقة التالية:
مفتاح API: <مفتاح RouterHub API ديالك>
Base URL: <القيمة من البداية السريعة ديال RouterHub API>
معرّف الموديل: <المعرّف الدقيق من كتالوغ الموديلات>
البروتوكول: <البروتوكول اللي كيدعمو الموديل المختار>باش تدير تطبيق عملي، حلّ البداية السريعة ديال الـ API، نسخ مثال الطلب، حط مفتاح الـ API بطريقة آمنة، وبدّل قيمة الموديل بالمعرّف الدقيق اللي اخترتي من الكتالوغ.
رحّل ربط موجود مع OpenRouter
إلى كان التطبيق ديالك كيستعمل OpenRouter من قبل، تبع دليل الترحيل ديال المستودع. ملف README كايحدّد ثلاثة ديال نقاط الترحيل: تبديل الـ base URL، استعمال مفتاح API ديال RouterHub، وربط معرّفات الموديلات.
استعمل هاد اللائحة قبل الاختبار:
- حدّث الـ base URL ديال المزوّد حسب توثيق الترحيل.
- بدّل بيانات الاعتماد القديمة بمفتاح API ديال RouterHub.
- راجع كل اسم ديال موديل وربطو بالمعرّف الدقيق ديال موديل RouterHub.
- تأكّد من البروتوكول اللي كيتوقّعو الموديل المختار.
- بعث طلب اختبار صغير قبل ما تنقل الربط للإنتاج.
باش تعرف السياق كامل على علاش تبدّل، قرا علاش تبدّل، اللي كيغطي المواضيع المذكورة فالتوثيق: الفوترة المسبقة، معرّفات الموديلات، والخيارات غير المراقبة.
راجع الأثمنة والنسخ
الأثمنة
دليل الأثمنة كيشرح أمثلة ديال الثمن لكل توكن. استعملو باش تقدّر تكلفة الخدمة اللي باغي تدير وتقارن بين الموديلات قبل ما تكبّر عدد الطلبات.
الموديلات غير المراقبة والمجرّدة من القيود
دليل الموديلات غير المراقبة والمجرّدة من القيود مخصّص لمقارنة هاد النسخ. قرا حتى دليل السلامة ديال المستودع، واستعمل أي موديل بطريقة قانونية ومسؤولة.
اكتشف حالات الاستعمال العملية
من بعد ما يخدم أول طلب، دليل حالات الاستعمال كيغطي البرمجة، الوكلاء، البحث، والكتابة. استعمل هاد الأمثلة باش توفّق بين عائلة الموديل والبروتوكول ونوع التطبيق اللي كتطوّر.
بالنسبة للأسئلة التشغيلية، راجع دليل حلّ المشاكل. كيهضر بالخصوص على المصادقة، ومعرّفات النماذج، والبروتوكولات. كيوفّر قسم الأسئلة الشائعة أجوبة مفصّلة أكثر، بينما كَيشرح المعجم المصطلحات المستعملة فالتوثيق كامل.
نصائح متقدمة
- فضّل المعرّفات الدقيقة: كوپي معرّفات النماذج من الكاتالوغ باش تتفادى الأخطاء الناتجة عن الاختلافات فالتسمية.
- تأكّد من البروتوكولات بكري: تحقّق من توافق البروتوكول قبل ما تبدا تصحّح مشاكل كود التطبيق.
- فرّق بين الإعدادات والكود: خلّي مفتاح API، والرابط الأساسي، ومعرّف النموذج قابلين للإعداد باش تسهّل الهجرة والاختبار.
- قدّر التكاليف قبل: استعمل أمثلة التسعير لكل رمز قبل تشغيل مهام كبيرة.
- استعمل مسارات التوثيق: اختار دليل الهجرة، أو البدء السريع، أو التسعير، أو حلّ المشاكل، عوض ما تعتبر كل مشكل فالتكامل مشكل عام فـ API.
- دير مراجعة ديال السلامة: ملي كتقيّم نسخ بلا قيود أو محيّدة، قرا إرشادات السلامة وقيّد الاستعمال بالأغراض القانونية.
الخلاصة
مستودع RouterHub هو نقطة انطلاق منظّمة لتقييم بديل لـ OpenRouter والتكامل مع API ديالو. بدا بالحصول على مفتاح API، واختار معرّف نموذج دقيق من الكاتالوغ، وتحقّق من البروتوكول، وتبع دليل البدء السريع ديال API. إلا كنت كتنقل تطبيق موجود، استعمل دليل الهجرة المخصّص، ومن بعد تحقّق من اعتبارات التسعير، والنسخ، والسلامة، وحلّ المشاكل قبل النشر.