كيف يعمل

تشرح هذه الصفحة المفاهيم التي يقوم عليها Model Router، فاقرأها مرة واحدة وستصبح جميع الصفحات الأخرى أوضح.

الرصيد المدفوع مسبقًا

تمتلك منشأتك رصيدًا مدفوعًا مسبقًا بالدولار الأمريكي. ولا يتحرك إلا في اتجاهين:

• يرتفع عند الشحن (يدويًا، أو عبر الشحن التلقائي، أو بتعديل يُضاف إلى حسابك). تظهر عمليات الشحن فورًا.
• ينخفض مع تراكم الاستخدام. تُبلغ خدمة الاستدلال عن الاستخدام مباشرةً، ويُسوّى مع رصيدك المدفوع مسبقًا كل 15 دقيقة، لذا قد يستغرق ظهور النشاط الحديث جدًا في Monthly usage بضع دقائق. ولا يسرد سجل المعاملات سوى عمليات الشحن وتعديلات الرصيد.

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

كتالوج النماذج

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

• تعطيل نماذج على مستوى الحساب في الإعدادات ← Models (يجب أن يبقى نموذج واحد على الأقل مفعّلًا).
• تقييد النماذج لكل مفتاح API أو لكل خدمة متصلة، أي قائمة أضيق فوق مجموعة النماذج المفعّلة في المنشأة.

يضم الكتالوج عنصرًا خاصًا هو auto (أي Auto Router) ليس له سعر خاص به. فهو يختار تلقائيًا لكل طلب أفضل نموذج بناءً على مدى تعقيد المطالبة، وتُحتسب عليك الرسوم بسعر النموذج الذي يختاره. راجع Models.

طريقتان لاستهلاك النماذج

1. الخدمات المتصلة

تتصل أجهزة وكيل الذكاء الاصطناعي المقترنة بمنشأتك بـ Model Router تلقائيًا، دون إدخال أي مفتاح API على الجهاز مطلقًا، ويمكن لـ Workflows الاتصال أيضًا. تظهر كل خدمة متصلة في الإعدادات ← Service Access & API Keys ضمن Connected Services مع أرقام إنفاقها الخاصة، ويمكنك منح كل منها حدود إنفاق وقيود نماذج وتجاوزات Guardrails خاصة بها. راجع Connected Services.

2. مفاتيح API الخاصة بك

يمكنك إنشاء مفاتيح API (تبدأ بـ phk_) لتتمكن البرامج والأنظمة التابعة لجهات خارجية التي تدعم BYOK (Bring Your Own Key) من الاتصال بالنماذج التي ينشرها Performance Hub. نقطة النهاية متوافقة مع OpenAI، فوجّه أي OpenAI SDK أو أداة إلى عنوان URL الأساسي وصادق باستخدام مفتاحك. راجع مفاتيح API وربط تطبيقك.

يسحب كلا المسارين من الرصيد نفسه، ويخضعان لحدود الإنفاق نفسها على مستوى الحساب، ويظهران في تحليلات Activity وLogs نفسها، ويمكن تقييد كل منهما على حدة.

الرصيد مقابل حدود الإنفاق

هاتان آليتان مختلفتان، وكلتاهما ساريتان:

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

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

كيفية معالجة الطلب

عند وصول طلب إلى نقطة النهاية، تُجرى عمليات التحقق بهذا الترتيب:

1. المصادقة: مفتاح API صالح أو هوية خدمة متصلة صالحة. بالنسبة إلى مفتاح API، تُرفض هنا المنشأة التي لم يُفعَّل فيها Model Router مع HTTP 403 ("Model Router is not enabled for this facility"). ويُستجاب لطلب عرض قائمة النماذج (GET /v1/models) مباشرة بعد المصادقة، لذا يظل يعمل برصيد صفري.
2. التحقق من الرصيد المدفوع مسبقًا: يجب أن يكون الرصيد المتاح أعلى من $0 (وبالنسبة إلى الخدمات المتصلة، يجب أيضًا أن يكون Model Router مفعّلًا)؛ وإلا يُرفض الطلب مع خطأ عدم كفاية الرصيد insufficient credits (HTTP 402).
3. حدود إنفاق الحساب: إذا تم تجاوز سقف يومي أو شهري أو مدى الحياة، يُرفض الطلب مع خطأ تجاوز الميزانية budget exceeded (HTTP 402) الذي يذكر موعد إعادة تعيين الفترة، وفق المنطقة الزمنية لمنشأتك.
4. حدود الإنفاق لكل مفتاح أو لكل خدمة: التحقق نفسه، مقتصرًا على المفتاح أو الخدمة المستدعية.
5. فحوص المطالبة: يعمل درع الحماية من حقن المطالبات وعوامل تصفية المحتوى المخصصة لديك على المطالبة. يؤدي عامل تصفية من نوع block أو اكتشاف محاولة حقن إلى رفض الطلب (HTTP 403، content policy violation)؛ أما عوامل التصفية من نوع redact فتعيد كتابة النصوص المطابقة إلى [REDACTED] وتسمح للطلب بالمتابعة.
6. توجيه النموذج: يحوّل Auto Router القيمة auto إلى نموذج محدد (ويُرسل الطلب الذي يحتوي على صورة إلى نموذج يدعم الرؤية تسمح به). تُصفّى النماذج الاحتياطية لتقتصر على تلك التي يُسمح للمفتاح باستخدامها، ويُطبَّق إعداد الاستدلال لديك عندما لا يحدد الطلب إعداده الخاص، وتُقيَّد حدود الإخراج المطلوبة بما يدعمه النموذج.
7. الاستدلال: تطبّق خدمة الاستدلال إخفاء معلومات التعريف الشخصية وحجب الأسرار (عند تفعيلهما) قبل وصول المطالبة إلى النموذج؛ ثم يُرسل الطلب إلى مزوّد النموذج وتُبث الاستجابة عائدة.

تُطبَّق حدود المعدل (الطلبات في الدقيقة والرموز المميزة في الدقيقة، إذا كانت مضبوطة على المفتاح أو الخدمة) طوال العملية؛ ويؤدي تجاوزها إلى إرجاع HTTP 429.

ما الذي يُسجَّل

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

أرقام الاستخدام والإنفاق المعروضة في الوحدة هي الأرقام نفسها المستخدمة في التطبيق، لذا فإن ما تراه بوصفه "limit reached" هو بالضبط ما يُحظر.

مسرد المصطلحات