دليل المنصة

تثبيت المجموعات

اقفل نموذجًا على مجموعات مزودين محددة وأسعارها بدلًا من التوجيه التلقائي إلى الأرخص.

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

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

تعرض صفحة تفاصيل كل نموذج كل مجموعة بسعر الإدخال والإخراج ضمن Group Pricing؛ وشارة الخصم في قائمة النماذج تعكس دائمًا أرخص مجموعة.

جدول أسعار المجموعات في صفحة تفاصيل نموذج

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

محدد مجموعات المزودين لكل نموذج في محرر المفتاح

تطفو النماذج المثبتة إلى الأعلى مع شارة تُظهر عدد المجموعات المقفلة عليها؛ ومسح الكل يعيد المفتاح إلى auto بالكامل. تعرض قائمة المفاتيح المفاتيح المثبتة كـ auto +N.

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

اجمع بين التثبيت والمراقبة لتعرف متى تغيّر مجموعاته أسعارها أو تتعطل، راجع الإشعارات

يمكنك أيضاً التثبيت لكل طلب دون تعديل المفتاح: أرسل ترويسة X-Group تحمل اسم المجموعة بالضبط. فهي تتفوق على التثبيت المحفوظ في المفتاح وعلى التوجيه التلقائي لذلك الطلب وحده. انسخ أي اسم مجموعة من جدول أسعار المجموعات في صفحة النموذج.

bash

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

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

إذا تعطلت كل المجموعات المثبتة لنموذج بينما لا يزال مزودون آخرون يخدمونه، تفشل الطلبات بخطأ موجه بدلًا من رسالة انشغال عامة:

json

{
  "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"
  }
}

وسّع التثبيت على المفتاح أو أزله، أو أعد المحاولة لاحقًا. النموذج نفسه لا يزال يعمل.

اجمع بين التثبيت والمراقبة لتعرف متى تغيّر مجموعاته أسعارها أو تتعطل، راجع الإشعارات

bash

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

json

{
  "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"
  }
}

وسّع التثبيت على المفتاح أو أزله، أو أعد المحاولة لاحقًا. النموذج نفسه لا يزال يعمل.