الانتقال من OpenRouter إلى Brievio: base_url واحد، مفتاح واحد

لنبدأ بالجانب المنصف: OpenRouter هو رائد الاتساع. مفتاح واحد، وعنوان URL أساسي واحد، فتصل إلى أكثر من 300 نموذج — بما في ذلك الذيل الطويل مفتوح المصدر (Llama وQwen وDeepSeek وMistral وعشرات من النماذج المضبوطة بدقة من المجتمع) الذي لا تعرضه أي واجهة API من المصدر الأول. إذا كانت مهمتك تقييم ساحة واسعة، أو الالتفاف حول الانقطاعات عبر المزوّدين، أو الوصول إلى نموذج مفتوح الأوزان متخصّص، فإن ذلك الفهرس ميزة حقيقية يصعب تكرارها. هذا المقال ليس هجوماً.

إنه دليل متى يناسب كلٌّ منهما. ثمة مجموعة مختلفة من المهام — تلك التي تريد فيها النموذج الرائد الأصلي من المصدر الأول بميزاته الأصلية سليمة، وفوترة يمكنك تدقيقها توكناً بتوكن، وصورة وفيديو على المفتاح نفسه، وخصماً لكل نموذج صغيراً بما يكفي ليكون حقيقياً. هنا تضيف الفرق gateway بمستوى المصدر الأول مثل Brievio إلى جانب OpenRouter، أو تنقل مسار الإنتاج إليه بالكامل. أما الانتقال نفسه فهو تغيير من سطر واحد في base_url إضافة إلى إعادة تسمية slug النموذج. وإليك القرار الصادق والآلية.

متى يكون OpenRouter هو القرار الصحيح

كن واضح النظر في هذا قبل أن تغيّر أي شيء. يكون OpenRouter هو الأنسب حين:

• تحتاج إلى الذيل الطويل مفتوح المصدر. Llama وQwen وDeepSeek وMistral والنماذج المضبوطة من المجتمع ليست على أي واجهة API من المصدر الأول. إذا كانت خارطة طريقك تلامس النماذج مفتوحة الأوزان، فأنت تريد ذلك الفهرس.
• تُجري تقييماً واسعاً. مقارنة عشرين نموذجاً عبر خمسة مزوّدين هي بالضبط ما بُني من أجله مُجمِّع من 300 نموذج. مفتاح واحد، مخطّط واحد، كل نموذج.
• تريد الانتقال الاحتياطي عبر المزوّدين بوصفه ميزة. يستطيع OpenRouter أن يرجع إلى مزوّدين upstream آخرين لنموذج بعينه. وبالنسبة لبعض ملامح التوافر، يكون ذلك الاتساع في التوجيه هو المقصود.
• تبحث عن أرخص مضيف لنموذج مفتوح بعينه. يُظهر السوق عدة مزوّدين لكل نموذج ويتيح لك الترتيب حسب السعر. وتلك رافعة حقيقية.

لا يختفي أيٌّ من ذلك بإضافة Brievio. تُبقي فرق كثيرة على OpenRouter لهذه المهام بالذات، وتوجّه فقط حركة الإنتاج من المصدر الأول إلى مكان آخر. عنوانا URL أساسيان، وقاعدة شيفرة واحدة.

متى يناسب أكثر gateway بمستوى المصدر الأول

الحجة للتبديل (أو لتقسيم الحركة) أضيق وأكثر تحديداً. لجوء إليها حين تكون هذه الأمور مهمة:

• تحتاج إلى النموذج الأصلي من المصدر الأول، بميزاته الأصلية سليمة. لا نموذجاً مضبوطاً ولا شبه مكافئ — بل Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 وGemini 2.5 Pro / Flash الحقيقية، باستخدام الأدوات الأصلي والرؤية وتخزين الـ prompt مؤقتاً وهي تعمل كما يوثّقها المزوّد. حين يكون سلوك نموذج رائد هو منتجك، فإن "قريب بما يكفي" لا يفي.
• تريد فوترة توكنات صادقة يمكنك تدقيقها. تكلفتك الحقيقية هي السعر × التوكنات، وعدّ التوكنات هو أسهل رقم يمكن نفخه. يبلّغ Brievio عن أعداد توكنات أصلية من المصدر الأول ويفوترها كما هي. وإذا لم تتحقق من ذلك قط، فهو اختبار ذاتي من عشرين سطراً.
• تريد الصورة والفيديو على المفتاح نفسه. Nano Banana وNano Banana Pro وGPT-Image-2 وVeo 3 تقع خلف بيانات الاعتماد نفسها ونفس العميل بشكل OpenAI الذي تستخدمه لنماذج المحادثة لديك — بلا حساب مزوّد ثانٍ، وبلا سطح فوترة منفصل.
• تريد خصماً صغيراً بما يكفي للثقة به. تعمل نماذج المحادثة بنحو 15٪ تحت القائمة الرسمية، والصورة والفيديو بنحو 37.5٪ تحت، منشوراً لكل نموذج مقابل السعر المرجعي الرسمي كي تتمكن من تدقيق الفارق. فالخصم المتواضع القابل للتفسير هو هامش على الحجم — لا دعم يجب استرداده في مكان لا تستطيع رؤيته.
• النداءات الفاشلة مجانية. استجابات 4xx و5xx لا تُفوتر، لذا فإن يوماً سيئاً لمزوّد upstream لا يتحوّل بهدوء إلى بند على فاتورتك.

الانتقال: base_url واحد، مفتاح واحد

لأن كلا الـ gateway ينفّذان واجهة OpenAI Chat Completions، فإن التبديل هو أصغر فرق في قاعدة شيفرتك. توجّه الـ SDK إلى مضيف جديد وتبدّل المفتاح. ويبقى البث، واستدعاء الدوال، ووضع JSON، وأشكال طلباتك دون مساس:

# الانتقال من OpenRouter هو فرق من سطرين: بدّل الـ base_url والمفتاح.
# كل ما عدا ذلك — الـ SDK الخاص بـ OpenAI، وأشكال طلباتك، والبث، والأدوات —
# يبقى كما هو تماماً، لأن كليهما يتحدث واجهة OpenAI Chat Completions.

from openai import OpenAI

# --- قبل: OpenRouter ---
client = OpenAI(
    api_key="sk-or-...",
    base_url="https://openrouter.ai/api/v1",
)

# --- بعد: Brievio ---
client = OpenAI(
    api_key="sk-brievio-...",
    base_url="https://api.brievio.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",                 # انظر مطابقة أسماء النماذج أدناه
    messages=[{"role": "user", "content": "Summarize this contract clause…"}],
)

إذا كنت قد وصلت إلى OpenRouter من الـ SDK الرسمي لـ OpenAI أصلاً، فسيبدو هذا مألوفاً — إنها الخطوة نفسها مثل الانتقال من OpenAI في عشر دقائق، لكن من أصل مختلف. بلا SDK جديد، وبلا إعادة كتابة لمواضع النداء لديك.

الشيء الوحيد الذي تغيّره: slugs النماذج

هذا هو الفرق السلوكي الوحيد الذي يستحق بضع دقائق من العناية. يضع OpenRouter كل نموذج في فضاء أسماء vendor/model — anthropic/claude-sonnet-4.6، google/gemini-2.5-flash — لأنه مع أكثر من 300 نموذج عبر مزوّدين كثيرين، يمنع فضاء الأسماء التصادمات. أما Brievio فيقدّم مجموعة منتقاة من المصدر الأول، لذا فإن الـ slugs بسيطة: claude-sonnet-4-6، gemini-2.5-flash. بلا بادئة vendor/.

# الشيء الوحيد الذي تلمسه فعلاً: slugs النماذج.
# يضع OpenRouter كل نموذج في فضاء أسماء "vendor/model" كي لا تتصادم 300+ نموذج
# من مزوّدين كثيرين أبداً. أما Brievio فيقدّم مجموعة منتقاة من المصدر الأول،
# لذا فإن الـ slugs بسيطة — بلا بادئة "vendor/".

MODEL_MAP = {
    # slug في OpenRouter             ->  slug في Brievio
    "anthropic/claude-opus-4.7":         "claude-opus-4-7",
    "anthropic/claude-sonnet-4.6":       "claude-sonnet-4-6",
    "anthropic/claude-haiku-4.5":        "claude-haiku-4-5",
    "google/gemini-2.5-pro":             "gemini-2.5-pro",
    "google/gemini-2.5-flash":           "gemini-2.5-flash",
    # الصورة + الفيديو يعيشان على المفتاح نفسه — بلا حساب مزوّد منفصل:
    # "nano-banana", "nano-banana-pro", "gpt-image-2", "veo-3"
}

def to_brievio(slug: str) -> str:
    return MODEL_MAP.get(slug, slug.split("/")[-1])

# اختصار عملي لـ Claude/Gemini: احذف البادئة وحوّل النقطة إلى شرطة في رقم
# الإصدار. "anthropic/claude-sonnet-4.6" -> "claude-sonnet-4-6". تحقق من كل واحد
# مقابل /models كي يفشل بصوت عالٍ عند خطأ مطبعي بدل أن يوجّه خطأً في صمت.

بالنسبة لـ Claude وGemini القاعدة آلية: احذف البادئة، واكتب رقم الإصدار بشرطات بدل النقطة (4.6 ← 4-6). احتفظ بقاموس مطابقة صغير بدل التلاعب بالنصوص على نحو أعمى، وتحقق من كل slug مقابل قائمة النماذج كي يفشل الخطأ المطبعي بصوت عالٍ عند الإقلاع بدل أن يوجّه في صمت إلى المكان الخاطئ. هذا هو عملية البحث والاستبدال الوحيدة التي يتطلبها الانتقال فعلاً.

طرح عملي

لست مضطراً للاختيار دفعة واحدة. المسار الأقل خطورة يعامل الـ gateway الاثنين بوصفهما مكمّلين:

• شغّلهما جنباً إلى جنب. أبقِ OpenRouter موجّهاً إلى الذيل الطويل مفتوح المصدر وإلى منظومة التقييم لديك. وأضف Brievio عميلاً ثانياً للنماذج الرائدة من المصدر الأول في مسار إنتاجك. عنوانا URL أساسيان، ومستودع واحد.
• ظلّل قبل أن تنتقل بالكامل. اعكس شريحة من الحركة الحية إلى Brievio وقارن الاستجابات وكائنات usage. أنت تتحقق من أن النموذج هو النموذج الأصلي من المصدر الأول وأن أعداد التوكنات تتطابق مع ما تتوقعه — وإن الاختبار الذاتي للتوكنات هو تماماً هذا الفحص، مؤتمتاً.
• انقل العمل متعدد الوسائط أولاً. إذا كنت اليوم تجمّع مزوّد صورة أو فيديو منفصلاً، فإن توحيد Nano Banana / GPT-Image-2 / Veo 3 على مفتاح واحد غالباً ما يكون أنظف مكسب مبكر — حسابات أقل، فاتورة واحدة، مسار مصادقة واحد.
• رقِّ حين يصبح الفرق مملاً. ما إن تتطابق الحركة المظلّلة وتتصالح الأرقام، بدّل الإعداد الافتراضي للإنتاج. وتراجع بعكس base_url واحد إن فاجأك أي شيء.

الخلاصة الصادقة

لا يتنافس OpenRouter وgateway بمستوى المصدر الأول في الحقيقة على المهمة نفسها. يحسّن OpenRouter من أجل الوصول — أوسع فهرس والذيل الطويل مفتوح المصدر تحت مفتاح واحد، وهو أمر حقيقي وقيّم. ويحسّن Brievio من أجل الإخلاص على مجموعة منتقاة — النماذج الرائدة الأصلية من المصدر الأول بميزاتها الأصلية سليمة، وفوترة توكنات صادقة قابلة للتدقيق، وصورة وفيديو على المفتاح نفسه، وخصماً لكل نموذج صغيراً بما يكفي للثقة به. وكلاهما يقع خلف base_url واحد متوافق مع OpenAI، وهو بالضبط سبب تشغيل فرق كثيرة لكليهما: اتساع حيث يحتاجون إلى الاتساع، وإخلاص حيث يهمّ ذلك.

إذا أردت النماذج الأصلية من المصدر الأول بسلوكها الأصلي وفوترة يمكنك التحقق منها، فإن الخطوة تكلّفك base_url واحداً، ومفتاحاً واحداً، وإعادة تسمية slug النموذج. اقرأ المقارنة جنباً إلى جنب في Brievio مقابل OpenRouter، وتصفّح النماذج والـ slugs بالضبط في قائمة النماذج، وشغّل الاختبار الذاتي للتوكنات ضد كليهما قبل أن تضع حركة حقيقية في أي مكان. فالقرار ينجو من التدقيق في كل الأحوال — وهو النوع الوحيد من القرارات الجدير بالإطلاق.