نطلق اليوم نقاط النهاية الخاصة. يضع OpenRouter بالفعل النماذج العامة التي يستخدمها فريقك خلف واجهة API واحدة. والآن يمكنه أيضًا خدمة النشرات التي يمتلكها فريقك وحده. إذا كنت تشغّل نموذجًا مضبوطًا بدقة، أو نشرًا مخصصًا لنموذج عام، أو سعة حجزتها لدى مزوّد، فيمكنك توجيهها عبر OpenRouter إلى جانب كل ما في الكتالوج. يحتفظ فريقك بواجهة API ومُعرّف النموذج (model slug) وتفضيلات التوجيه التي يستخدمها اليوم. نقاط النهاية الخاصة مرئية فقط داخل مؤسستك.
نقاط النهاية الخاصة هي إضافة لخطة Enterprise. اطلب من ممثل حسابك تفعيلها لمؤسستك، أو تحدث إلى الفريق.
ما يمكنك فعله بها
كانت النماذج المضبوطة بدقة والسعة المحجوزة تعني تكاملًا ثانيًا بجوار OpenRouter. الآن تسجّل النشر كنقطة نهاية خاصة وتستدعيها عبر واجهة API التي تستخدمها بالفعل، مع مزوّدين عموميين كخيار احتياطي إذا تعطلت أو بلغت حد المعدل الخاص بها. فقط المؤسسات التي توافق عليها يمكنها رؤيتها، ولا تظهر أبدًا في قوائم النماذج العامة أو التصنيفات أو البحث أو الرسوم البيانية أو المعايير المرجعية.
إذا كان لمؤسستك نشر مخصص على Azure لـ DeepSeek V4 Pro على سبيل المثال، فيمكنك تسجيله كنقطة نهاية خاصة لـ deepseek/deepseek-v4-pro وتستمر تطبيقاتك في استدعاء ذلك المُعرّف. بالنسبة لمؤسستك ينتقل افتراضيًا إلى مقدمة قائمة المزوّدين، و Model Fallbacks, Provider Selection وبقية ميزات التوجيه تعمل كما تعمل مع أي مزوّد. يصل OpenRouter إليه بمفتاح Azure الخاص بك عبر BYOK، لذا يفوترتك Azure مباشرة.
تحصل السعة المحجوزة على المعاملة نفسها. وجّه نقطة نهاية خاصة إليها وسيذهب إليها trafik مؤسستك أولًا افتراضيًا. عندما تصل إلى حد المعدل أو تصبح غير متاحة، يمكن لـ OpenRouter إرسال الفائض إلى مزوّدين عموميين، وفقًا لتفضيلات المزوّدين وإعدادات fallback الخاصة بـ BYOK التي حددتها.
إعداد نقطة نهاية
بمجرد تفعيل نقاط النهاية الخاصة، يسجّل مسؤول المؤسسة النشر من صفحة Private Endpoints في حسابك. يجب أن يستضيف مزوّد نشرًا ندعمه لـ BYOK، لأن OpenRouter يصل إليه بمفتاحك الخاص. ويجب أيضًا أن يقدّم نموذجًا موجودًا بالفعل في كتالوج OpenRouter، لأنه يرث مُعرّف النموذج (slug) وقدراته. يمكنك إرفاق أسعارك الخاصة بحيث تظهر نقطة النهاية بدقة في تقارير التكاليف، وتصرّح بما إذا كان النشر يحتفظ بالطلبات (prompts).
قبل توجيه أي شيء إلى نقطة النهاية الجديدة، يرسل OpenRouter طلبًا حقيقيًا واحدًا عبر مفتاح المزوّد المحفوظ في أحد مساحات العمل لديك. يثبت ذلك الطلب أن المفتاح مقبول، وأن النشر يتحدث بصيغة المتوافقة مع OpenAI، وأن البث يعمل، وأن بيانات الاستخدام تُعاد للفوترة، وأن معرّف النموذج (model ID) يطابق ما سجّلته. بمجرد نجاحه، تفعّل نقطة النهاية ويمكن لمساحات العمل في مؤسستك استدعاؤها بواسطة مُعرّف النموذج. وحتى ذلك الحين تبقى مخفية ولا يمكن استدعاؤها.
إدارة نقاط النهاية من الكود
إذا كنت تشغّل أكثر من حفنة من نقاط النهاية، أو تحتفظ ببنيتك التحتية في الكود، يمكنك تجاوز صفحة الإعدادات. تغطي Private Endpoints API دورة الحياة الكاملة، من تسجيل مسودة وتشغيل اختبارات الفحص إلى التفعيل وتحديث الأسعار والإيقاف المؤقت والحذف. تُصادَق باستخدام Management API keyللمؤسسة، واستدعاء create واحد يسجّل ويختبر ويفعّل نقطة نهاية.
curl https://openrouter.ai/api/v1/private-endpoints \
-H "Authorization: Bearer $OPENROUTER_MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gpt-4o-prod" \
-d '{
"model_permaslug": "openai/gpt-4o-2024-08-06",
"provider_slug": "openai",
"base_url": "https://api.openai.com/v1",
"upstream_model_id": "gpt-4o-2024-08-06",
"pricing": { "prompt": "0.0000025", "completion": "0.00001" },
"activate": { "workspace_id": "<workspace-id>" }
}'إذا فشلت اختبارات الفحص، تُحفظ المسودة وتعود مع الاختبارات الفاشلة، حتى تتمكن من إصلاحها والمحاولة مجددًا. ال Idempotency-Key تجعل الترويسة عمليات إعادة المحاولة آمنة (المفتاح المكرر يُرجِع نقطة النهاية التي أنشأها الطلب الأول). الـ OpenRouter Terraform provider يغلّف كل هذا في openrouter_private_endpoint مورد (resource)، بحيث terraform apply يسجّل نقطة النهاية ويختبرها وينشّطها، بينما terraform destroy يزيلها.
معلومة مفيدة
- جعل نقطة النهاية خاصة لا يجعلها نقطة نهاية Zero Data Retention مزوّدك يتعامل مع الطلبات التوجيهية تمامًا كما كان سابقًا، ويقوم OpenRouter بتسجيل سياسة البيانات التي تعلنها عند تسجيل النشر.
- يمكن لنقطة النهاية الخاصة استخدام In-Region Routing إذا تمكّن OpenRouter من استنتاج منطقة من عنوانه، أو إذا أعلنتها أثناء الإعداد. تُوجَّه الطلبات إلى
us.openrouter.aiأوeu.openrouter.aiإلى نشرتك داخل تلك المنطقة. يذكر دليل In-Region Routing المزوّدين المدعومين. - يجب حفظ مفتاح المزوّد الخاص بك ضمن BYOK في كل مساحة عمل تستدعي نقطة النهاية، كما يحتاج إليها طلب الاختبار أثناء الإعداد أيضًا.
- يمكن لكل مؤسسة أن تمتلك حتى 10 نقاط نهاية خاصة افتراضيًا، وتُحتسب نقاط النهاية التي لا تزال قيد الإعداد ضمن هذا الحد.
ابدأ
تُعد Private Endpoints إضافة إلى خطة Enterprise. اطلب من ممثل حسابك تمكينها لمؤسستك، أو تحدث إلى الفريق.
بعد تمكينها، يمكن لمسؤول المؤسسة إضافة أول نقطة نهاية لك من صفحة Private Endpoints في حسابك أو باستخدام مفتاح Management API عبر واجهة Private Endpoints API.