معرّفات النماذج والمتغيرات

تستخدم معرّفات النماذج في api14 الصيغة provider/model، مثل openai/gpt-5-mini. مرّر المعرّف في الحقل model لأي طلب.

{ "model": "anthropic/claude-sonnet-4.5" }

العثور على معرّفات النماذج

• تصفّح صفحة النماذج، فيها كل نموذج مع معرّفه وأسعاره وطول سياقه وقدراته.
• استدعِ GET /models من الكود، وصفِّ بالفئة عبر ?category=image. راجع النماذج.

بعض الأمثلة:

المعرّفات حساسة لحالة الأحرف. المعرّف غير المعروف أو المعطّل يُعيد 404 model_not_found.

المتغيرات

المتغير (variant) لاحقة بعد نقطتين رأسيتين تغيّر طريقة خدمة الطلب. تعمل المتغيرات مع النموذج الأساسي نفسه، وتسري قواعد توفر النموذج الأساسي وقائمة السماح.

{ "model": "openai/gpt-5-mini:online" }

:nitro و:floor اختصاران لترتيب المزوّدين، وهما مثل provider: { sort: "throughput" } وprovider: { sort: "price" }. راجع توجيه المزوّد والبدائل.

النماذج الاحتياطية

أرسل مصفوفة models لتجربة نماذج أخرى عندما يفشل الأول أو لا يكون متاحًا:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

يجب أن يكون كل نموذج في القائمة متاحًا ومسموحًا به لمفتاحك وخطتك، وإلا يُرفض الطلب قبل إرساله. يخبرك الحقل model في الاستجابة بالنموذج الذي أجاب، وتدفع سعر ذلك النموذج.

قوائم السماح والخطط

• المفتاح الذي له قائمة نماذج مسموح بها لا يستطيع استخدام سوى المعرّفات المدرجة، وأي معرّف آخر يُعيد 403 model_not_allowed.
• كل الخطط، بما فيها المجانية، تغطي جميع فئات النماذج، ومنها الفيديو والموسيقى/الصوت. الخطة المقصورة على فئات معيّنة تُعيد 403 plan_required لبقية الفئات. راجع الأسعار والفوترة.

تغيّر النماذج

يتحدث الكتالوج تلقائيًا. تظهر النماذج الجديدة من تلقاء نفسها، وتُعيد النماذج المحذوفة 404 model_not_found. ثبّت المعرّفات بدقة في الإنتاج واستخدم النماذج الاحتياطية models لزيادة المرونة.