الانتقال إلى المحتوى الرئيسي
ضع معرّف مزوّد ونقطتين أمام معرّف النموذج، مثل baseten:thinking-machines/inkling-small، لتشغيل الطلب على ذلك المزوّد فقط، دون الرجوع إلى مزوّد آخر. الصيغة هي <provider-id>:<canonical-model-id>. تفصل النقطتان الأوليان المزوّد؛ أما النقطتان بعد نطاق أسماء النموذج فتبقيان جزءًا من معرّف النموذج. في google-ai-studio:google/gemma-4-26b-a4b:free، المزوّد هو google-ai-studio والنموذج هو google/gemma-4-26b-a4b:free. إذا كنت تفضّل مزوّدًا فقط وتريد الرجوع إلى بديل عند فشله، فاستخدم معرّف النموذج العادي مع عناصر التحكم في التوجيه والبدائل بدلًا من ذلك.

أرسل طلبًا

استخدم المعرّف المقيّد في أي مكان تقبل فيه نقطة النهاية معرّف نموذج.

ما يجب أن يجتازه المزوّد مع ذلك

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

ادمجه مع حقول provider أو routing

يجب أن يتوافق المقيِّد مع أي حقول توجيه صريحة. يُقبل provider.only أو routing.only المطابق:
تُرفض قائمة السماح التي تسمّي مزوّدين آخرين، أو قائمة التجاهل التي تحتوي على المزوّد المقيِّد، بالخطأ provider_qualified_model_conflict:

اطلب مسارًا مجانيًا لدى مزوّد واحد

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

معرّفات المزوّدين وأسماؤهم البديلة

استخدم معرّف مزوّد من كتالوج مزوّدي Phaseo (راجع مزوّدو API). تُحوَّل المعرّفات إلى أحرف صغيرة، وتُربط الأسماء البديلة القديمة أو التجارية المعروفة بالمعرّف المرجعي: يصبح كل من NovitaAI وnovita-ai القيمة novita. تُرفض المعرّفات المشوّهة وغير المعروفة قبل اختيار المزوّد؛ ولا تُرسل أبدًا إلى المزوّد كجزء من اسم النموذج.

أخطاء التحقق

يعيد المعرّف المقيّد غير الصالح رمز HTTP 400 مع رمز الخطأ validation_error. يبيّن reason وdetails[].keyword السبب:
لأشكال الأخطاء الأخرى، راجع الأخطاء وتصحيحها.
آخر تعديل في ٥ نوفمبر ٢٠٢٦