انتقل إلى المحتوى

توثيق واجهة Fileverity API

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

نماذج Fileverity API وأسعارها وحدودها، والرصيد المدفوع مسبقًا وصلاحيته واسترداده، ورصيد البدء المجاني، وحدود الإنفاق، وإعادة الشحن التلقائي، وتنبيهات انخفاض الرصيد.

عرض بصيغة Markdownآخر تحديث: 2026-11-04

تعمل API بنظام الدفع المسبق. تضيف مبلغًا إلى رصيد مساحة العمل، ويُخصم منه سعر كل فحص. لا يوجد اشتراك، ويغطي رصيد واحد جميع النماذج.

النماذج والأسعار

النموذجالنوعالسعرالمُدخلالنسخة المؤرَّخة
fvimg-2 (FVIMG V2)صورة⁦US$ 1.99⁩ لكل فحص صورةjpeg وpng وwebp؛ حتى 10 ميغابايت و40 ميغابكسلfvimg-2-2026-10-30
fvdoc-3 (FVDOC V3)مستند⁦US$ 5.99⁩ لكل فحص مستندpdf وdocx وdoc وrtf وodt وpptx وtxt؛ حتى 50 ميغابايت و100 صفحةfvdoc-3-2026-11-03
fvdoc-3-text (FVDOC V3 Text)نص⁦US$ 0.14⁩ لكل 1,000 حرفen وfr وde وes وzh؛ 100 كلمة على الأقل، وحتى 100,000 حرفfvdoc-3-text-2026-11-03

الأسعار بالدولار الأمريكي، ويعيدها GET /models أيضًا بالسنتات في الحقل pricing.unit_amount. يشير معرّف النموذج إلى نسخته المؤرَّخة الحالية. مرّر معرّف نسخة مؤرَّخة في الحقل model لتثبيت الطلب على نسخة بعينها. راجع كشف النصوص لمعرفة كيفية احتساب النص.

رصيد البدء المجاني

تبدأ مساحة عملك الأولى بعدد 5 من فحوصات الصور أو المستندات المجانية، إضافةً إلى 5,000 حرف نصي مجاني. يُمنح رصيد بدء مجاني واحد لكل شخص، وعدد محدود لكل نطاق بريد إلكتروني لشركة. ولا تحصل عليه عناوين البريد الإلكتروني المؤقتة. على الزملاء الانضمام عبر دعوة. يُستخدم رصيد البدء المجاني قبل رصيدك. وتحمل نتيجة الفحص المجاني للصورة أو المستند usage.funding: trial وusage.amount: 0. أما الأحرف النصية التي تتجاوز المجانية فتُحتسب بالسعر المعتاد.

الرصيد المدفوع مسبقًا

  • أضف رصيدًا في لوحة التحكم ضمن الرصيد. الحد الأدنى لإضافة الرصيد هو ⁦US$ 19⁩. وتجد الإيصالات في المكان نفسه.
  • عند إنشاء تحليل، يُحجز سعره من الرصيد، ويُخصم نهائيًا عند نجاح التحليل.
  • لا تُحتسب رسوم على التحليلات الفاشلة والملغاة ولا على الطلبات التي ترفضها الخدمة قبل فحصها. ويُحرَّر المبلغ المحجوز.
  • عندما لا يكفي الرصيد لتغطية طلب، تعيد API الخطأ insufficient_balance (رمز الحالة 402 في HTTP).

لا تخصم مفاتيح الاختبار أبدًا من الرصيد أو من رصيد البدء المجاني.

حدود الإنفاق

يمكن أن يكون لكل مفتاح API حد إنفاق شهري بمبلغ صحيح بالدولار الأمريكي، يُعاد تعيينه في الأول من كل شهر (UTC). ولا يستطيع تعيينه أو تغييره سوى مالكي مساحة العمل ومسؤوليها. ويُرفض الطلب الذي سيتجاوز الحد برمز الخطأ spend_limit_reached ولا تُحتسب عليه رسوم. راجع المصادقة والمفاتيح.

تنبيهات انخفاض الرصيد وإعادة الشحن التلقائي

  • تنبيه انخفاض الرصيد. حدّد حدًّا في لوحة التحكم. وعندما ينخفض الرصيد عنه، يتلقى المالكون والمسؤولون رسالة بريد إلكتروني ويُرسل حدث Webhook باسم balance.low.
  • إعادة الشحن التلقائي. احفظ بطاقة في لوحة التحكم، ثم اختر حدًّا ومبلغًا. وعندما ينخفض الرصيد عن الحد، يُخصم المبلغ من البطاقة ويُضاف إلى الرصيد. وإذا فشلت عملية الخصم أو احتاجت إلى تأكيد من بنكك، تتوقف إعادة الشحن التلقائي من تلقاء نفسها ويُرسل بريد إلكتروني إلى المالكين والمسؤولين.

صلاحية الرصيد واسترداده

  • الصلاحية. يظل الرصيد صالحًا مدة 12 شهرًا بعد آخر عملية إضافة رصيد في مساحة العمل، سواء أكانت إضافة يدوية أم إعادة شحن تلقائي. وتمدّ كل عملية إضافة رصيد صلاحية الرصيد كله، لا صلاحية المبلغ المضاف حديثًا فقط. وينتهي أي رصيد لم يُستخدم بعد مرور 12 شهرًا على آخر عملية إضافة رصيد.
  • التذكير. قبل تاريخ الانتهاء بنحو 30 يومًا، يتلقى المالكون والمسؤولون الذين يديرون الفوترة رسالة بريد إلكتروني واحدة تذكر المبلغ والتاريخ، وتوضح أن أي عملية إضافة رصيد تمدّ صلاحية الرصيد. وتُرسل الرسالة مرة واحدة عن كل آخر عملية إضافة رصيد، ولا تُرسل إلا حين يكون الرصيد أكبر من الصفر.
  • رصيد البدء المجاني. ليس لرصيد البدء المجاني قيمة نقدية، ولا يمكن تحويله أو استبداله، ولا تنتهي صلاحيته بموجب هذه القاعدة.
  • الاسترداد. عمليات إضافة الرصيد غير قابلة للاسترداد، إلا حيث يقتضي القانون خلاف ذلك أو ينص عليه اتفاق مكتوب. ولا تُحتسب رسوم على عمليات الفحص الفاشلة، ويُحرَّر المبلغ المحجوز تلقائيًا. وإذا أوقفت Fileverity تقديم الفحوصات المدفوعة عبر لوحة التحكم وAPI، فإنها تردّ أي رصيد غير مستخدم.
  • الملكية. يتبع الرصيد مساحة العمل التي يخصها، ولا يمكن تحويله إلى مساحة عمل أخرى أو استبداله بوحدات فحص الموقع. وحدات الفحص المشتراة على الموقع منتج منفصل له شروطه الخاصة.

الأسعار بالدولار الأمريكي، مع إضافة الضريبة المطبّقة. راجع شروط الخدمة للاطلاع على الشروط الكاملة.

الاطلاع على الرسوم المحتسبة

يتضمن كل تحليل الحقل usage.amount بالسنتات. وتتضمن عمليات كشف النصوص الحقلين usage.billed_units وusage.free_characters. وتعرض لوحة التحكم الإنفاق ومخططًا للاستخدام وتصديرًا بصيغة CSV.