الأدلة
النماذج والأسعار
افهم معرّفات النماذج والمزوّدين والأسعار المنشورة والخصومات ووحدات الفوترة وكيفية احتساب سعر الطلب.
تُنشر أسعار النماذج بالدولار الأمريكي. قد يتوفر النموذج عبر أكثر من مزوّد أعلى، وقد ينشر كل مزوّد سعرًا مختلفًا للعميل. يوضح هذا الدليل مصدر تلك الأسعار وكيفية حساب تكلفة طلب قبل إرساله.
العثور على معرّف النموذج
استخدم معرّف النموذج الذي يعيده API. لا تبنِ معرّفًا من اسم العرض أو slug الصفحة.
| endpoint | ما يعيده |
|---|---|
GET /api/v1/models | كل فئة نماذج ممكّنة |
GET /api/v1/videos/models | نماذج توليد الفيديو |
GET /api/v1/decisions/models | نماذج القرار |
يقبل GET /api/v1/models أيضًا exclude_video_and_decisions=true ومرشّح provider اختياريًا. يقرأ الاكتشاف الكتالوج ولا يفرض رسومًا على استدعاء النموذج.
لا تملك نماذج الصور endpoint مخصصًا للسرد. صفِّ GET /api/v1/models حسب model_kind: "image_generation"؛ راجع توليد الصور.
لعرض قابل للتصفح، افتح كتالوج النماذج أو صفحة التسعير. تعرض صفحات تفاصيل النماذج حدود السياق والبروتوكولات وكل سعر مزوّد منشور.
المزوّدون والقنوات
يحمل كل نموذج قائمة قنوات عامة. القناة هي إعداد مزوّد أعلى واحد لذلك النموذج، مثل Anthropic أو Azure أو Google أو قناة Claude مخفّضة السعر.
- تحدد
is_defaultالقناة المستخدمة للسعر الرئيسي والمسار الافتراضي. - تحدد
runnableما إذا كانت القناة متاحة حاليًا للطلبات. - يحتوي
standard_pricingعلى أسعار المزوّد القياسية. discount_multiplierهو مضاعف البيع من 0 إلى 1.- تكون
pricing_modeإماconfigured_ratesأوupstream_cost.
ترتب صفحة النموذج المزوّدين مع الافتراضي أولًا، ثم حسب سعر إدخال العميل من الأقل إلى الأعلى. لاختيار مزوّد صراحةً، راجع القنوات وتوجيه المزوّد.
كيف يُحسب سعر العميل
لقناة configured_rates:
customer price = standard rate × discount multiplierعلى سبيل المثال، القناة ذات سعر الإدخال القياسي $1.00 لكل مليون رمز ومضاعف 0.8 تفرض $0.80 لكل مليون رمز.
بالنسبة لقناة upstream_cost، تكون standard_pricing هي null وليست صفرًا. تستند الفوترة إلى تكلفة التوليد المُبلّغ عنها مضروبةً في الخصم المجمّد. وتعرض صفحة النموذج القاعدة الفعلية لتلك القناة.
تُعرض أسعار الرموز لكل مليون رمز لسهولة القراءة. وتستخدم الفوترة دقة السعر لكل رمز في لقطة الأسعار الحالية.
وحدات الفوترة
| الوحدة | الاستخدام النموذجي | كيفية القياس |
|---|---|---|
| الرموز | الدردشة والاستدلال والتضمينات وتوليد النص | رموز الإدخال والإخراج منفصلة؛ وقد تكون لقراءات ذاكرة التخزين المؤقت وكتاباتها أسعارها الخاصة |
| رموز الصور | توليد الصور وتحريرها | رموز صور الإدخال والإخراج منفصلة؛ يعتمد عدد رموز الإخراج لكل صورة على الدقة |
| الطلبات | بعض endpoints الصور والأدوات المساعدة | رسم ثابت لكل استدعاء |
| الثواني أو الفئات | توليد الفيديو | المدة أو الدقة أو المدخلات المرجعية أو شرط منشور آخر |
إذا تحققت عدة شروط سعر، يُطبّق أول شرط مطابق مدرج في تفاصيل تسعير النموذج. تحقق من صفحة تفاصيل النموذج لمعرفة الفئات قبل تقدير مهمة كبيرة.
أسعار ذاكرة التخزين المؤقت
عندما ينشر النموذج input_cache_read أو input_cache_write، تظهر تلك الأسعار في الكتالوج وعلى صفحة النموذج. يُبلّغ عن استخدام ذاكرة التخزين المؤقت في استجابة البروتوكول؛ ولا يُضمن إصابة ذاكرة التخزين المؤقت (cache hit)، فهي تعتمد على المزوّد الأعلى والطلب. ولا يضيف Felo مفتاحًا منفصلًا لذاكرة التخزين المؤقت.
أين تتحقق من الأسعار
- صفحة التسعير — قارن النماذج والمزوّدين.
- صفحة تفاصيل النموذج — جدول الأسعار الكامل والفئات والشروط.
- API كتالوج النماذج — البيانات نفسها بصيغة JSON، محدّثة خلال 60 ثانية.
لا تضع الأسعار مباشرة في تطبيقك. اقرأ الكتالوج أو اعرض رابطًا إلى صفحة التسعير حتى لا يؤدي تغيّر السعر إلى إفساد تقدير التكلفة بصمت.
تقدير تكلفة طلب
- حدد معرّف النموذج والقناة التي تخطط لاستخدامها.
- اقرأ أسعار الإدخال والإخراج وذاكرة التخزين المؤقت لتلك القناة.
- اضرب في أعداد الرموز المتوقعة، أو استخدم سعر الطلب أو المدة للنماذج غير المعتمدة على الرموز.
- أضف أي فئة شرطية تنطبق.
- اترك هامشًا لإعادة المحاولات وتباين المخرجات.