مستويات النموذج

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

المستوى الافتراضي

اسم النموذج المجرد يستخدم دائمًا المستوى الافتراضي. الطلبات الموجودة تستمر في العمل دون تغيير عندما يكتسب النموذج مستوى آخر.

{ "model": "gpt-image-2" }

اختر مستوى

أضف نقطتين عموديتين ومعرّف المستوى إلى اسم النموذج:

{ "model": "gpt-image-2:<tier>" }

هذا يعمل مع نماذج النص والصورة والفيديو والصوت، في أي مكان يسمي الطلب نموذجًا: حقل model في نص JSON، حقل نموذج model لتحميل الصوت، وقطعة النموذج من مسار Gemini الأصلي. في مسار Gemini، الإجراء يبقى الأخير:

POST /v1beta/models/<model>:<tier>:generateContent

ابحث عن مستويات النموذج

• في كل صفحة نموذج، يظهر مفتاح اختيار المستوى أعلى جدول الأسعار ويعرض أسعار كل مستوى ومعرّف النموذج المراد استدعاؤه. في الصفحات التي تعرض سعرًا واحدًا فقط، تعرض المستويات في جدول مستويات الأسعار بدلاً من ذلك. لا يظهر أيٌّ منهما إلا عندما يكون للنموذج أكثر من مستوى واحد.
• دليل Markdown /models/<page>/llms.txt لكل نموذج يسرد الأسعار الكاملة لجميع المستويات.
• GET /v1/models يسرد <model>:<tier> بجانب <model> لكل نموذج يمكن لمفتاحك استدعاؤه في أكثر من مستوى واحد.

في Playground لنماذج النصوص، يتبدل منتقي المستوى بين نفس المستويات. يستخدم Playground لنماذج الصور والفيديو والصوت المستوى الافتراضي؛ استدعِ المستويات الأخرى عبر API.

الفواتير والسلوك

• طلب المستوى يعمل فقط في هذا المستوى ويتم فرض رسوم عليه بسعر هذا المستوى.
• إذا لم يستطع المستوى خدمة الطلب، فإن الطلب يفشل. لن يتحول أبدًا إلى مستوى آخر، لذا لن يتم فرض رسوم عليه بسعر مختلف.
• الاستجابات ونتائج المهام تبلغ اسم النموذج المجرد.
• مفتاح تم إنشاؤه لمستوى واحد فقط يمكنه استدعاء هذا المستوى وليس أي مستوى آخر.

الأخطاء

راجع الأخطاء لمعرفة شكل الاستجابة.