شرح ميزة BYOK في OpenRouter: تكلفة أقل، سرعة أكبر، وتطور مستمر

إذا قرأت أن ميزة BYOK في OpenRouter مجانية لأول مليون طلب شهرياً، فقد قرأت رقماً ألغته OpenRouter في 14 يوليو 2026. لا يزال هذا الرقم موجوداً في بعض صفحات التوثيق القديمة الخاصة بـ OpenRouter، وهو السبب في تكراره في العديد من الأدلة.

الشروط الحالية أفضل لمعظم الفرق، وتعد ميزة BYOK الطريقة الأوفر لاستخدام OpenRouter. كما أنها كانت أسرع بالنسبة لنا عند استخدام Anthropic. سيظل المفتاح المتعطل يعود إلى حساب OpenRouter الخاص بك ما لم تقم بتغيير ذلك في إعدادات المفتاح وتقييد المزودين في الطلب.

ما هي ميزة OpenRouter BYOK؟

تعني ميزة BYOK (أحضر مفتاحك الخاص) إضافة بيانات اعتماد مزود الخدمة الخاص بك إلى OpenRouter. عند توجيه الطلبات إلى ذلك المزود، يتم استخدام مفتاحك، ويقوم المزود بمحاسبتك مباشرة، مع تطبيق حدود الاستخدام وشروط التعاقد الخاصة بك. لا تزال OpenRouter تتولى التوجيه والترجمة والتحليلات، وتمر طلباتك (prompts) من خلالها.

تتم إضافة المفاتيح لكل مساحة عمل (workspace)، سواء من خلال إعدادات BYOK الخاصة بمساحة العمل أو عبر واجهة برمجة تطبيقات الإدارة. اعتباراً من 5 أكتوبر، تدعم 72 من أصل 92 مزوداً مدرجاً في OpenRouter ميزة BYOK، بما في ذلك Anthropic وOpenAI وGoogle Vertex وAI Studio وAmazon Bedrock وAzure وDeepSeek وMistral وGroq. يتطلب Bedrock إما مفتاح API خاص بـ Bedrock أو بيانات اعتماد AWS، بينما يتطلب Vertex ملف JSON لحساب الخدمة، ويتطلب Azure اسم المورد والمفتاح.

تكاليف ميزة OpenRouter BYOK

في خطتي Standard وBusiness، لا توجد رسوم من OpenRouter على أول 25,000 دولار من استخدام ميزة BYOK شهرياً. أما في خطة Enterprise، فالمخصصات مخصصة (custom)؛ حيث لا تزال بعض الأدلة تذكر مبلغ 200,000 دولار، لكن صفحة الأسئلة الشائعة والأسعار في OpenRouter تشير الآن إلى أنها مخصصة. فوق هذا الحد، تفرض OpenRouter رسوماً بنسبة 5% مما سيكلفه نفس النموذج والمزود على OpenRouter، وتُخصم هذه الرسوم من رصيد OpenRouter الخاص بك.

قارن ذلك بشراء الرصيد، حيث تدفع سعر قائمة OpenRouter للاستنتاج بالإضافة إلى رسوم على كل عملية شراء: 5.5% في خطة Standard بحد أدنى 0.80 دولار، أو 8% في خطة Business.

تعد ميزة BYOK أوفر عند أي حجم استخدام، وتكون الفجوة أكبر تحت حد المخصصات وفي خطة Business. هناك ثلاث تفاصيل تغير هذه الأرقام.

أولاً، تُخصم رسوم BYOK من رصيد OpenRouter، وشراء هذا الرصيد يخضع لرسوم شراء بنسبة 5.5%. لذا، فوق حد المخصصات، تكون الرسوم الفعلية حوالي 5.3% من المبلغ الزائد بدلاً من 5%، وتحتاج إلى الاحتفاظ برصيد حتى لو كانت جميع عمليات الاستنتاج تعمل على مفاتيحك الخاصة. تتضمن أرقام BYOK في الجدول هذا الأمر.

ثانياً، تُحسب الرسوم بناءً على سعر قائمة OpenRouter، وليس على ما تدفعه للمزود. إذا تفاوضت على خصم 20% مع Anthropic، فإن استخداماً بقيمة 100,000 دولار بسعر القائمة سيكلفك 80,000 دولار، وتكون رسوم الـ 3,956 دولار حوالي 5% من فاتورتك الفعلية بدلاً من 4%.

ثالثاً، من السهل فقدان تتبع إنفاق BYOK. فهو لا يُحتسب ضمن ميزانيات حواجز الحماية (guardrail) أو مساحات العمل ما لم تقم بتفعيل include_byok_in_budgets، لذا قد تبدو الميزانية أقل من سقفها بينما يرتفع إنفاق المزود. كما أن صفحة النشاط (Activity) تقدر إنفاق BYOK بأسعار السوق، وليس بخصمك الخاص، لذا يمكن للوحة تحكم OpenRouter وميزانياتها وفاتورة المزود أن تظهر ثلاثة أرقام مختلفة.

Take control of your LLM traffic

Route models, enforce budgets, and monitor every request from your own infrastructure.

Book a demo

هل ميزة OpenRouter BYOK أسرع؟

في اختباراتنا على Anthropic، كانت أسرع. أرسلنا نفس الطلبات إلى Claude Haiku 4.5 مباشرة، ومن خلال OpenRouter باستخدام الرصيد، ومن خلال OpenRouter باستخدام مفتاح Anthropic الخاص بنا. أضاف الرصيد حوالي 200 مللي ثانية للرمز الأول، بينما أضاف مفتاحنا الخاص حوالي 120 مللي ثانية. بعد الرمز الأول، كان مفتاحنا يبث البيانات بنفس سرعة الاتصال المباشر، بينما كان الرصيد يولد البيانات ببطء ملحوظ. في إجابة نموذجية مكونة من 290 رمزاً، جعل ذلك مفتاحنا الخاص أسرع بحوالي 0.6 ثانية. القياس الكامل وحدوده موجود في مقالتنا حول OpenRouter latency on Anthropic.

أما بالنسبة لـ OpenAI، فقد سارت الأمور بشكل مختلف؛ حيث وصلت الأرصدة إلى الرمز الأول (token) قبل مفتاحنا الخاص بمدة تتراوح بين 23 إلى 50 مللي ثانية، وكلاهما تم بثه بنفس المعدل. تعتمد سرعة استخدام مفتاحك الخاص (BYOK) على المزود نفسه، كما أن الحساب الذي يخدم طلبك يؤثر على السرعة بطرق لا يمكنك رؤيتها من الخارج.

يغير استخدام مفتاحك الخاص (BYOK) أيضاً الجهة التي تُطبق عليها حدود المعدل. عند استخدام الأرصدة، يتولى OpenRouter إدارة حدود المزود الخاصة بك، أما عند استخدام مفتاحك الخاص، فستحصل على حدود حساب المزود التابع لك، والتي قد تكون أعلى أو أقل. مقالتنا حول حدود معدل OpenRouter تغطي بقية التفاصيل.

إلى أين تذهب الطلبات عند فشل مفتاحك

عند فشل المفتاح، لا يزال يتعين على الطلب أن يذهب إلى مكان ما.

بشكل افتراضي، يحاول OpenRouter استخدام مفتاحك أولاً. إذا فشل المفتاح أو وصل إلى حد المعدل، ينتقل OpenRouter إلى سعته المشتركة الخاصة بذلك المزود، ويتم خصم التكلفة من أرصدتك. يحتوي كل مفتاح على إعداد احتياطي للسعة المشتركة بثلاثة مستويات: استخدام السعة المشتركة (وهو الإعداد الافتراضي)، وعدم استخدام السعة المشتركة أبداً للنماذج التي ينطبق عليها المفتاح، وعدم استخدام السعة المشتركة أبداً لأي نموذج لدى ذلك المزود.

يمنع المستوى الأقوى OpenRouter من استخدام حساب Anthropic الخاص به. لكنه لا يمنع OpenRouter من إرسال الطلب إلى مزود مختلف. فإذا فشل مفتاح Anthropic الخاص بك وطلبت نموذج Claude، يمكن لـ OpenRouter تقديمه من خلال Bedrock أو Vertex باستخدام حسابه الخاص وأرصدتك. يذكر دليل BYOK الخاص بـ OpenRouter ذلك صراحةً، والحل الذي يقدمه هو تقييد المزودين في الطلب، على سبيل المثال باستخدام provider.only.

هناك قاعدتان إضافيتان للتوجيه تغيران وجهة الطلب. توجد المفاتيح في قسمين: المفاتيح ذات الأولوية التي يتم تجربتها بالترتيب قبل نقاط نهاية OpenRouter، والمفاتيح الاحتياطية التي يتم تجربتها فقط بعد نقاط النهاية تلك، لذا فإن المفتاح "الاحتياطي" في القسم الاحتياطي يعمل بعد حساب OpenRouter وليس قبله. كما أن مفاتيح BYOK تتجاوز ترتيب المزودين الخاص بك. إذا أرسلت order: ["amazon-bedrock", "google-vertex"] ولكنك لا تملك سوى مفتاح لـ Vertex، فسيتم تجربة Vertex أولاً. يذكر دليل OpenRouter أنه لا توجد حالياً طريقة لتغيير هذا السلوك.

لذا، إذا كان سبب اعتمادك لـ BYOK هو إبقاء الاستدلال على حساب مزود متعاقد معه، فقم بتعيين أقوى مستوى احتياطي على المفتاح وقيد المزودين في كل طلب. فاستخدام أحدهما بمفرده لا يكفي.

BYOK وسياسات البيانات

لا يغير مفتاحك الخاص نقاط النهاية التي تسمح بها سياسات البيانات الخاصة بك. إذا قمت بتعيين data_collection: "deny" أو فرضت عدم الاحتفاظ بالبيانات نهائياً، فإن تلك القواعد لا تزال تنطبق على نقاط نهاية مفتاحك.

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

فيما يتعلق بتخزين المفاتيح، يقول OpenRouter إن مفاتيح المزود "مشفرة بشكل آمن". لكنه لا يوثق نظام التشفير المستخدم، أو ما إذا كانت المفاتيح التي يديرها العميل مدعومة، أو كيفية التعامل مع تدوير المفاتيح.

تشغيل ميزة BYOK عملياً

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

عندما أجرينا اختباراتنا في سبتمبر، لم تكن لوحة التحكم توضح مسار الفوترة الذي يستخدمه مفتاح API معين. الطريقة الموثوقة للتحقق هي إجراء طلب واحد يطلب بيانات التوجيه الوصفية (metadata):

import os, requests

r = requests.post(
    "https://openrouter.ai/api/v1/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
             "X-OpenRouter-Experimental-Metadata": "enabled"},
    json={"model": "openai/gpt-4o-mini",
          "messages": [{"role": "user", "content": "hi"}],
          "max_tokens": 5,
          "provider": {"order": ["openai"], "allow_fallbacks": False}},
)
meta = r.json().get("openrouter_metadata") or {}
print("is_byok:", meta.get("is_byok"))

إذا ظهرت النتيجة False لمفتاح كنت تتوقع أن يعمل عبر BYOK، فأنت تدفع باستخدام الأرصدة. هذا العنوان (header) لا يزال في المرحلة التجريبية، لذا تأكد من استمرارية عمله قبل الاعتماد عليه في مشاريعك. عند فشل طلبات BYOK، تتضمن البيانات الوصفية الأولية في صفحة النشاط (Activity page) ما يلي: provider_responses، والتي تعرض رمز الحالة من كل مزود تمت تجربته، وهي أسرع طريقة للتمييز بين المفتاح المُلغى وبين مشكلات حدود المعدل أو الصلاحيات.

ما الذي يتغير

تغيرت أسعار BYOK هذا الصيف، وقد صرحت OpenRouter بأنها ستتغير مجدداً.

• 14 يوليو 2026: تم تغيير أساس احتساب البدل المجاني من عدد الطلبات (مليون طلب شهرياً في نظام الدفع حسب الاستخدام) إلى قيمة السعر المعلن بالدولار (25,000 دولار شهرياً). أما الرسوم البالغة 5% فلم تتغير.
• معلق منذ يونيو 2025: إعلان OpenRouter الخاص بهيكل الرسوم الحالي، والذي تم تحديثه آخر مرة في يونيو 2026، يشير إلى أن رسوم BYOK البالغة 5% "ستتم إزالتها في المستقبل واستبدالها باشتراك شهري ثابت"، مع تحديد الأسعار لاحقاً.
• سبتمبر 2026: رفعت خطة الأعمال ذاتية الخدمة رسوم الأرصدة إلى 8% للفرق التي تحتاج إلى توجيه داخل المنطقة، مع الإبقاء على نفس بدل BYOK، مما يعزز من ميزة BYOK في تلك الخطة.
• أغسطس 2026: وافقت Stripe على الاستحواذ على OpenRouter. حتى أوائل أكتوبر، لم يتم الإعلان عن إتمام الصفقة، ولكن الأسعار المستقبلية ستحددها الجهة المالكة الجديدة.

قم بنمذجة تكاليفك بناءً على الشروط الحالية، وراجعها مرة أخرى كل ربع سنة. إذا تم تطبيق نظام الاشتراك، فإن نقطة التعادل مقابل الأرصدة ستتغير، خاصة للفرق التي يقل استهلاكها عن بدل الـ 25,000 دولار والتي لا تدفع حالياً أي شيء لـ OpenRouter.

متى تكون ميزة BYOK مجدية

تعد ميزة "استخدام مفاتيحك الخاصة" (BYOK) خياراً مجدياً إذا كان لديك بالفعل حسابات لدى المزودين الذين تتعامل معهم، أو إذا كنت قد تفاوضت على أسعار معينة أو التزمت بإنفاق مبالغ ترغب في استهلاكها. كما أنها المسار الأسرع عندما يكون زمن الاستجابة في نموذج Claude أمراً بالغ الأهمية. وإذا كانت شروط الامتثال الخاصة بك مدرجة ضمن عقد المزود، فإن هذا الخيار لا يعمل إلا إذا قمت أيضاً بتقييد المزودين في كل طلب.

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

نهج TrueFoundry في هذا الشأن

تقوم بوابة TrueFoundry للذكاء الاصطناعي باستدعاء المزودين باستخدام بيانات اعتمادك الخاصة، لأنها تعمل داخل سحابتك الخاصة (VPC) أو مركز بياناتك، ولا يوجد حساب مزود مشترك تحتها. في حال فشل أحد المفاتيح، يتم الرجوع فقط إلى ما يسمح به إعداد التوجيه الخاص بك. توفر البوابة أكثر من 1000 نموذج لغوي ضخم (LLM) عبر واجهة برمجة تطبيقات واحدة متوافقة مع OpenAI، وتضيف حوالي 3 إلى 4 مللي ثانية من زمن المعالجة، وتتعامل مع أكثر من 350 طلباً في الثانية (RPS) على وحدة معالجة مركزية افتراضية واحدة.

إذا كنت ستستمر في استخدام OpenRouter، فيمكن لـ TrueFoundry أن تعمل كبوابة أمامها، مما يتيح لك إدارة الميزانيات وحدود الاستخدام والتحكم في الوصول من مكان واحد تديره أنت. إن نظرتنا العامة حول كيفية عمل OpenRouter تغطي الحالات التي يكون فيها هذا الإعداد مناسباً.

Try TrueFoundry AI Gateway

Connect your models and start managing LLM traffic through one API.

Sign up

قراءات ذات صلة

• بدائل OpenRouter، مقارنة بين الخيارات المتاحة لفرق العمل في بيئات الإنتاج
• نماذج OpenRouter المجانية، حول ما هو مجاني وما هي التكلفة البديلة لذلك
• التخزين المؤقت للمطالبات (Prompt Caching) في OpenRouter، حول متى يوفر التخزين المؤقت المال ومتى يكلفك المزيد
• ما هي بوابة النماذج اللغوية الضخمة (LLM Gateway)؟، البنية العامة لها

الخلاصة

تعد ميزة BYOK في OpenRouter هي الطريقة الأقل تكلفة لاستخدام OpenRouter بأي حجم، وقد أثبتت اختباراتنا أنها المسار الأسرع عند استخدام Claude. افتراضياً، في حال فشل أحد المفاتيح، يتم الرجوع إلى سعة OpenRouter، ويمكن للطلب أن يصل إلى مزود آخر ما لم تقم بتقييد المزودين في ذلك الطلب. قم بضبط أقوى مستوى للرجوع التلقائي، وقيد المزودين في الطلب، وفعّل ميزة BYOK في ميزانياتك، وأعد مراجعة الشروط عند توفر الاشتراك الموعود.

لاستدعاء المزودين باستخدام مفاتيحك الخاصة دون وجود حساب مشترك تحتها، تعرف على كيفية عمل بوابة TrueFoundry للذكاء الاصطناعي باستخدام مفاتيح المزود الخاصة بك.