الأسئلة الشائعة

الفوترة والأرصدة

كيف تُحتسب أرصدة الخدمة، ومتى تعيد الشحن، وماذا تعني استجابة 402.

استخدام API على منصة Felo API مدفوع مسبقًا. تشتري أرصدة خدمة مقوّمة بالدولار الأمريكي، ويُخصم كل طلب من ذلك الرصيد بالسعر المطبق.

كيف تعمل الفوترة

شراء الرصيد يمنحك أرصدة خدمة، وليس رصيدًا نقديًا تحتفظ به المنصة.
أرصدة الخدمة مقوّمة بالدولار الأمريكي حتى يمكن التعبير عن الرسوم بالدولار.
يبدأ إعادة الشحن من $1. لا يلزم اشتراك.
تُستخدم الأرصدة فقط لتغطية رسوم API على المنصة. ولا يمكن سحبها أو استبدالها نقدًا.
عمليات إعادة الشحن المكتملة غير قابلة للاسترداد، بما في ذلك الأرصدة غير المستخدمة، إلا حيث يلزم القانون المعمول به ذلك.

يدفع رصيد الأرصدة نفسه مقابل استدعاءات النماذج واستدعاءات Data API واستدعاءات Felo API. ولا تحتاج إلى حساب أو رصيد منفصل لكل مزوّد.

تكلفة الطلب

تعتمد الرسوم على endpoint:

السطح	أساس الفوترة
Model API	أسعار رموز الإدخال والإخراج والتخزين المؤقت، بالإضافة إلى أي أدوات خاضعة للفوترة؛ ويُطبّق مضاعف خصم القناة
Data API	أساس الفوترة المنشور لذلك endpoint، والذي قد يكون لكل طلب ناجح، أو لكل عنصر مُعاد، أو بناءً على الاستخدام الفعلي
Felo APIs (`/v2`)	سعر مخرجات سير العمل ذلك

تُعرض أسعار النماذج لكل مليون رمز في صفحة التسعير وعلى صفحة كل نموذج. راجع النماذج والتسعير للمعادلة وتقدير التكلفة.

تحقق من رصيدك وأعد الشحن

افتح Console Billing. تعرض لوحة التحكم رصيد أرصدة الخدمة الحالي ومبالغ إعادة الشحن وسجلات الاستخدام. تعتمد طرق الدفع المتاحة على منطقتك وتظهر عند الدفع.

استجابة 402

تعني الاستجابة 402 أن الرصيد لا يغطي الاستدعاء:

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

ما يجب فعله:

تحقق من الرصيد في Console Billing.
أعد الشحن.
أعد إرسال الطلب. الاستجابة 402 ليست حد معدل، لذا لن يؤدي الانتظار إلى إزالتها.

بالنسبة لمهمة غير متزامنة، تعني الاستجابة 402 عند الإرسال أن المهمة لم تُنشأ أبدًا. تحقق من endpoint حالة المهمة قبل إعادة الإرسال.

الفوترة مقابل حدود المعدل

هذان حدّان مختلفان:

الأرصدة تحدّ من المبلغ الذي يمكنك إنفاقه. ونفادها يعيد 402.
حدود المعدل تحدّ من سرعة الاستدعاء. وتجاوزها يعيد 429.

راجع الأخطاء والحدود وإعادة المحاولة لرؤوس 429 وقواعد إعادة المحاولة.

الاشتراكات والأرصدة

استخدام API مدفوع دائمًا من أرصدة الخدمة. السلوك الوحيد للاشتراك الموصوف في هذه المستندات هو إعفاء /v2/chat من حد المعدل للحسابات ذات اشتراك Felo مدفوع فعّال؛ وهو لا يحل محل أرصدة الخدمة.

أسئلة الفوترة

لرسوم متنازع عليها أو إعادة شحن لم تصل، تواصل مع الدعم مع:

بريد الحساب
الوقت التقريبي للرسم
request_id من أي خطأ ذي صلة
مبلغ إعادة الشحن ومرجع الدفع

لا ترسل مفتاح API الكامل أبدًا.