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

افتح مفاتيح API، وأنشئ مفتاحًا أو حرّره، وافتح منتقي المجموعات. ابحث عن نموذج، وانقره، وحدّد مجموعة أو أكثر. وتبقى النماذج التي لم تمسسها على الوضع التلقائي.

تُرتَّب النماذج المثبّتة في الأعلى مع شارة تُظهر عدد مجموعاتها. وزرّ Clear all يعيد المفتاح إلى الوضع التلقائي. وتُظهر قائمة المفاتيح المفاتيحَ المثبّتة بصيغة auto +N.
بدلاً من تحديد المزودين واحدًا تلو الآخر، اسحب نطاق السعر ذا المقبضين على أي نموذج لتوجيه الطلبات عبر المزودين الذين يقع سعرهم ضمن النطاق فقط. وبما أن الاختيار يتم حسب السعر لا حسب الاسم، فإن المزودين الجدد الذين يدخلون النطاق يُضافون تلقائيًا.

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

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

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

عند تحديد نطاق سعر، تأتي المسارات التي يضيفها النطاق ولم تخترها بعد قائمتك، الأرخص أولاً. والمزوّد الذي يدخل النطاق لاحقًا يوضع هناك أيضًا.
يُوجَّه النموذج المثبت عبر مجموعاته المثبتة فقط، وينتقل إلى التالي عند الأخطاء بالترتيب المحدد في ترتيب البدائل. المجموعة التي تخدم الطلب تحدد السعر المحتسب.
اجمع بين التثبيت والمراقبة لتعرف متى تغيّر مجموعاته أسعارها أو تتعطل، راجع الإشعارات
لتثبيت طلب واحد دون تغيير المفتاح، أرسل ترويسة X-Group باسم المجموعة تمامًا. فهي تتجاوز تثبيت المفتاح والتوجيه التلقائي. انسخ الأسماء من Group Pricing.
curl https://api.test.wanmo.ai/v1/chat/completions \
-H "Authorization: Bearer $UNOROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Group: glm-new-relay-glm-5.2" \
-d '{
"model": "glm-5.2",
"messages": [{ "role": "user", "content": "Hello" }]
}'يجب أن تسمّي الترويسة مجموعة يجوز للمفتاح استخدامها، وإلّا رُفض الطلب. وتبقى النماذج غير المثبّتة على التوجيه إلى الأرخص.
إن تعطّلت كلّ المجموعات المثبّتة بينما ما زال مزوّدون آخرون يخدّمون النموذج، تفشل الطلبات بخطأ محدّد بدل رسالة انشغال عامّة:
{
"error": {
"message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
"type": "new_api_error",
"code": "get_channel_failed"
}
}وسّع التثبيت أو أزله، أو أعد المحاولة لاحقًا. فالنموذج نفسه يعمل.