دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

كيفاش توصل لنماذج الذكاء الاصطناعي الرائدة وغير الخاضعة للرقابة باستعمال RouterHub

تعلّم كيفاش تهيّأ RouterHub، تختار نموذجاً حديثاً، وتبعث الطلبات باستعمال OpenAI SDK أو Anthropic SDK أو cURL. هاد الدليل كيغطي حتى الأدوات المتوافقة، والفوترة، وتقييم النماذج، وتخزين البرومبتات مؤقتاً، وعزل المشاريع، والنشر المسؤول.

حوالي 18 دقايق ديال القراية
كيفاش توصل لنماذج الذكاء الاصطناعي الرائدة وغير الخاضعة للرقابة باستعمال RouterHub

شنو كيدير RouterHub

RouterHub هو بوابة API بالذكاء الاصطناعي كتوفّر الولوج لعائلات نماذج Claude وGPT وGemini وGrok وDeepSeek وGLM وQwen بحساب واحد، ورصيد واحد، ومفتاح API واحد. كيدعم واجهات متوافقة مع OpenAI وAnthropic، وهاد الشي كيخلّي بزاف ديال التطبيقات الموجودة تبدّل المزوّد غير بتغيير مفتاح API وعنوان URL الأساسي ومعرّف النموذج.

الكتالوغ كيشمل نماذج frontier عادية، وزايد عليها بعض النماذج غير الخاضعة للرقابة والمجرّدة من آليات الرفض ملي كتكون متوفّرة. النموذج غير الخاضع للرقابة هو نسخة مصمّمة باش ترفض طلبات أقل من الإصدار العادي. النموذج هو المحرّك، بينما API هي الاتصال اللي كيستعملو التطبيق ديالك باش يوصل ليه.

مهم: تقليل سلوك الرفض ماشي ضمانة بأن النموذج غادي يجاوب على كل طلب. السلوك كيختلف حسب النموذج والإصدار والتعليمات وسياسة المزوّد. كتبقى مسؤول على الاستعمال القانوني والأخلاقي، ووضع وسائل الحماية المناسبة، والمراجعة البشرية.

الخصائص الرئيسية

  • حساب واحد مع عائلات النماذج: استعمل Claude وGPT وGemini وGrok وDeepSeek وGLM وQwen بلا ما تدير تكامل منفصل لكل عائلة.
  • التوافق مع OpenAI: ربط OpenAI SDK والتطبيقات اللي كتقبل base_url مخصّص.
  • التوافق مع Anthropic: استعمل Anthropic SDK والزبناء اللي كيخدمو بطريقة Anthropic بحال Claude Code.
  • اختيارات غير خاضعة للرقابة: قيّم النسخ غير الخاضعة للرقابة والنسخ المجرّدة من آليات الرفض جنباً إلى جنب مع النماذج العادية ملي كتكون متوفّرة.
  • الفوترة حسب الاستعمال: خلّص على كل token بلا اشتراك شهري ولا رسوم على المقاعد.
  • تخزين التعليمات مؤقتاً: البدايات المتكررة ديال التعليمات تقدر تتحاسب بثمن أقل ديال الإدخال المخزّن مؤقتاً.
  • عزل المشاريع: أنشئ مفاتيح API منفصلة باش تقسّم المشاريع وتراقب الاستعمال.
  • شحن مرن: زِد الرصيد مسبقاً بالبطاقة أو بالعملة الرقمية.

اختار عائلة النماذج

الاختيار ديالك خاصو يعكس نوع الخدمة، ماشي غير اسم العائلة. RouterHub كيعرض معرّفات النماذج الحالية، وحدود السياق، والأثمنة، والتوفّر فلوحة التحكم.

  • Claude: الاستدلال المطوّل، والكتابة، ووكلاء البرمجة.
  • GPT: المساعدات العامة، واستعمال الأدوات، والإخراج المنظّم.
  • Gemini: سير العمل متعدد الوسائط، والبحث، والمهام ذات السياق الطويل.
  • Grok: توليد الأفكار والأجوبة اللي كتكون بحال الآنية.
  • DeepSeek: البرمجة، والاستدلال، والوكلاء الاقتصاديين فالتكلفة.
  • GLM: سير عمل الوكلاء، والبرمجة، والمهام الثنائية اللغة.
  • Qwen: قراءة الوثائق الطويلة وسير عمل الوكلاء.

التوفّر ديال النماذج كيتبدّل ملي المزوّدين كينشرو إصدارات جديدة. ديما نسخ معرّف نموذج حالي من لوحة تحكم RouterHub وما تفترضش بأن معرّف قديم مازال خدام.

التثبيت والإعداد

1. أنشئ حساباً ومفتاح API

سجّل عبر صفحة التسجيل والإعداد ديال RouterHub. مفتاح API اللي كيتولّد كيبدا بـ sk-. نظرة عامة فلوحة التحكم كتعرض حتى عنوان URL الأساسي الدقيق اللي كيحتاجو الواجهة اللي اخترتي.

2. خزّن بيانات الدخول فمتغيّرات البيئة

تجنّب تحط بيانات الدخول مباشرة فملفات المصدر. صدّر المفتاح وعنوان URL الأساسي المتوافق مع OpenAI فواجهة الأوامر ديالك:

export ROUTERHUB_API_KEY="sk-..."
export ROUTERHUB_BASE_URL="https://.../v1"

نسخ عنوان URL الفعلي من لوحة التحكم. بالنسبة لزبناء Anthropic، استعمل عنوان URL الأساسي المتوافق مع Anthropic اللي مبيّن تما، وما تفترضش بأنه مطابق لعنوان URL المتوافق مع OpenAI.

3. ثبّت SDK اللي كيحتاجو التطبيق ديالك

فمثال Python المتوافق مع OpenAI، ثبّت OpenAI SDK:

python -m pip install openai

فالمثال المتوافق مع Anthropic، ثبّت Anthropic SDK:

python -m pip install anthropic

كتحتاج غير SDK اللي كيستعملو المشروع ديالك. طلب مباشر بـ cURL ما كيحتاج حتى حزمة من حزم Python.

الاستعمال الأساسي مع OpenAI SDK

أنشئ زبون OpenAI، ودخّل بيانات RouterHub، وبدّل MODEL_ID بمعرّف حالي من لوحة التحكم:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ROUTERHUB_API_KEY"],
    base_url=os.environ["ROUTERHUB_BASE_URL"],
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[
        {
            "role": "system",
            "content": "نتَ مساعد دقيق ومتعاون."
        },
        {
            "role": "user",
            "content": "شرح مفاضلات توجيه النماذج ففقرتين."
        },
    ],
)

print(response.choices[0].message.content)

الحقل model كيتحكّم فالنموذج المتاح اللي غادي يعالج الطلب. رسالة النظام كتحدّد السلوك العام ديال المساعد، ورسالة المستخدم فيها المهمة.

الاستعمال الأساسي مع Anthropic SDK

استعمل نقطة النهاية المتوافقة مع Anthropic من لوحة التحكم ملي كتخدم بـ Anthropic SDK:

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ROUTERHUB_API_KEY"],
    base_url=os.environ["ROUTERHUB_BASE_URL"],
)

message = client.messages.create(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "كتب ملاحظة إصدار موجزة لأداة موجهة للمطوّرين."
        }
    ],
)

print(message.content[0].text)

الطلب ديال Anthropic كيستعمل صيغة Messages API وكيحدّد max_tokens باش يحدّ من الجواب اللي غادي يتولّد. تأكّد باللي المتغيّر البيئي ديالك فيه الرابط المتوافق مع Anthropic قبل ما تشغّل هاد المثال.

جرّب الـ API باستعمال cURL

طلب HTTP مباشر يقدر يعاونك تتأكّد من بيانات الدخول وتوفّر الموديل قبل ما تزيد SDK لتطبيق كبير:

curl "$ROUTERHUB_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ROUTERHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Hello from the RouterHub quickstart."
      }
    ]
  }'

إلى فشل الطلب، راجع مفتاح API، والرابط الأساسي، ومسار نقطة النهاية، ومعرّف الموديل الحالي. التوفّر والمعرّفات يقدرو يتبدلو من بعد تحديثات الموديلات عند المزوّد الأصلي.

ربط أدوات المطوّرين الموجودة

RouterHub يقدر يخدم مع العملاء اللي كيسمحو بمزوّد مخصّص متوافق مع OpenAI ولا Anthropic:

  • Claude Code: وجّه إعدادات الرابط الأساسي ديال Anthropic نحو RouterHub.
  • Cursor: زِد RouterHub كمزوّد مخصّص متوافق مع OpenAI.
  • Codex CLI: كوّن بروفايل ديال مزوّد متوافق مع OpenAI.
  • OpenCode: عيّن مزوّد مخصّص واستعمل معرّف موديل صحيح.
  • LangChain وLlamaIndex: استعمل المحوّلات ديالهم المتوافقة مع OpenAI.
  • تطبيقات أخرى متوافقة: بدّل الرابط الأساسي ومفتاح API، ومن بعد اختار معرّف موديل مدعوم.

تبع التوثيق الخاص بالعميل فالمستودع إلا كانت شي أداة كتحتاج متغيّرات بيئية إضافية ولا إعدادات ديال المزوّد.

نصائح متقدّمة

قارن الموديلات باستعمال مجموعة اختبارات قابلة لإعادة التنفيذ

ما تقيّمش موديل اعتماداً على prompt واحد. بنِ مجموعة اختبارات صغيرة كتمثّل المهام الحقيقية ديالك، ومن بعد صيفط نفس الـ prompts لعدة عائلات ديال الموديلات. قارن جودة الأجوبة، وسلوك الرفض، والكمون، والاستمرارية، وتكلفة التوكنات قبل ما تختار موديل للإنتاج.

عاود الاختبار باستعمال الإصدارات الدقيقة ديال الموديلات

السلوك كيعتمد على الإصدار. Prompt خدام مع إصدار واحد يقدر يعطي نتائج مختلفة من بعد تحديث عند المزوّد الأصلي. سجّل معرّف الموديل المستعمل فكل تقييم، وعاود الاختبارات المهمة كلما بدّلتي الموديلات ولا الإصدارات.

استعمل مفاتيح API مختلفة

دير مفاتيح مختلفة للتطوير، والاختبار، والإنتاج، ولا لكل عميل. هاد الشي كيعزل المشاريع وكيخلّي تتبّع الاستعمال أسهل من لوحة التحكّم المشتركة. ما تعمّرش تحط المفاتيح فمستودع ولا تكشفها فـ browser code.

صمّم الـ prompts باش تستافد من التخزين المؤقّت

تخزين الـ prompts مؤقتاً يقدر ينقص التكلفة المفوترة ديال بادئات الإدخال المتكرّرة. خلّي التعليمات الثابتة ولا السياق المشترك فبداية الطلبات إلا كانت هاد البنية مناسبة للتطبيق ديالك، وحط محتوى المستخدم المتغيّر من بعد.

تأكّد من الأسعار والحدود الحالية

RouterHub كيستعمل الفوترة حسب عدد التوكنات وما كيحتاجش اشتراك. ولكن أسعار المزوّدين، وتوفّر الموديلات، والحدود يقدرو يتبدلو. راجع لوحة التحكّم قبل ما تقدّر تكاليف الإنتاج ولا تعتمد على موديل معيّن.

خلّي وسائل الحماية على مستوى التطبيق

النسخ غير المراقَبة والنسخ اللي تحيّدات منها آليات الرفض كتنقص الرفض، ولكن ما كتلغيش الحاجة للتحقّق. زِد وسائل حماية مناسبة للاستعمال ديالك، وراجع المخرجات الحسّاسة، وتبع شروط المزوّدين، وامتثل للقوانين المعمول بها. هاد الشي مهم خصوصاً بالنسبة للوكلاء المستقلّين والمساعدين الموجّهين للعموم.

حالات استعمال عملية

  • قارن سلوك السياسات بين الإصدارات فبحوث سلامة الذكاء الاصطناعي والاختبارات الهجومية.
  • بنِ مسارات عمل للكتابة الإبداعية مع رفض أقل وسط المشاهد، ومع عملية مراجعة تحريرية منفصلة.
  • وجّه مهام البرمجة بين Claude وGPT وDeepSeek وGLM من خلال عملاء برمجة متوافقين.
  • اختبر prompts متعددة اللغات عبر عدة عائلات ديال الموديلات بلا ما تعاود تبني الربط.
  • أنشئ مسارات عمل لتلخيص السياقات الطويلة وتحليل الوثائق.
  • شغّل خلفيات الدردشة والمساعدين مع توحيد المفاتيح والفوترة والاستعمال.

الخلاصة

RouterHub كيوفّر بوابة متوافقة لاختبار واستعمال عدة عائلات من الموديلات المتقدّمة من خلال حساب واحد. بدا بالحصول على مفتاح، ونسخ الرابط الأساسي الصحيح ومعرّف الموديل الحالي، وتشغيل طلب بسيط باستعمال SDK ولا cURL. قبل النشر فالإنتاج، قارن الموديلات بطريقة منهجية، وعزل مفاتيح المشاريع، وتحقّق من الأسعار الحالية، وخلي ضوابط السلامة المناسبة والإشراف البشري حاضرين.