انتقل إلى المحتوى
اللغة: ar
القائمة

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

نظرة عامة

تفحص واجهة Fileverity API الصور والمستندات والنصوص العادية بحثًا عن التوليد بالذكاء الاصطناعي والتلاعب والفقرات المكتوبة بالذكاء الاصطناعي. عنوان URL الأساسي والنماذج والاصطلاحات ونقطة البداية.

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

تتيح واجهة Fileverity API لبرمجياتك فحص الصور والمستندات والنصوص العادية بنماذج Fileverity. ويغطي مفتاح API واحد ورصيد مساحة عمل واحد مدفوع مسبقًا جميع النماذج. ونتائج الصور والمستندات هي التقارير نفسها التي ينتجها الموقع، ويحمل كل تقرير منها رقم تقرير وطابعًا زمنيًا وفق RFC 3161 وصفحة تحقق عامة.

هل أنت جديد هنا؟ اتبع البدء السريع لتجري أول استدعاء خلال دقائق، أو احصل على مفتاح اختبار وابدأ باستدعاء API فورًا. وللاطلاع على نظرة عامة على المنتج، راجع صفحة API وواجهة API لكشف الصور المولَّدة بالذكاء الاصطناعي وواجهة API لكشف تزوير المستندات.

النماذج

النموذجما يفحصهطريقة الاستدعاء
fvimg-2 (FVIMG V2)الصور: التوليد بالذكاء الاصطناعي والتعديلات الموضعية وبيانات Content Credentials والبيانات الوصفية. نظرة عامة: واجهة API لكشف الصور المولَّدة بالذكاء الاصطناعيارفع الملف عبر POST /files، ثم استدعِ POST /analyses
fvdoc-3 (FVDOC V3)المستندات: النص المكتوب بالذكاء الاصطناعي والصور المضمَّنة وسجل التعديلات والتوقيعات. نظرة عامة: واجهة API لكشف تزوير المستنداتارفع الملف عبر POST /files، ثم استدعِ POST /analyses
fvdoc-3-text (FVDOC V3 Text)نص عادي: مكتوب بالذكاء الاصطناعي أو مكتوب جزئيًا بالذكاء الاصطناعي أو كتبه إنسان، مع تعليم الفقرات المكتوبة بالذكاء الاصطناعياستدعاء متزامن واحد إلى POST /text/detections

الأسعار والحدود ومعرّفات النسخ المؤرَّخة مدرجة في الأسعار والفوترة.

الاصطلاحات

  • عنوان URL الأساسي. https://api.fileverity.com/v1. عبر HTTPS فقط.
  • الصيغة. الطلبات بصيغة JSON، باستثناء رفع الملفات فهي بصيغة multipart. والاستجابات بصيغة JSON، باستثناء تقرير PDF. الطوابع الزمنية بصيغة Unix بالثواني، باستثناء ما داخل result.report حيث تُكتب الأوقات بصيغة ISO 8601 بالتوقيت العالمي المنسق (UTC).
  • المصادقة. مفتاح API من نوع Bearer في ترويسة Authorization. راجع المصادقة والمفاتيح.
  • المعرّفات. تحمل الكائنات بادئة: file_ للملفات، وan_ للتحليلات، وtdet_ لعمليات كشف النصوص، وevt_ لأحداث Webhook، وreq_ للطلبات. وتبدو أرقام التقارير بهذا الشكل: FV-XXXX-XXXX-XXXX.
  • معرّفات الطلبات. تحمل كل استجابة ترويسة x-request-id، ويكرر كل خطأ المعرّف نفسه في error.request_id. اذكره عندما تتواصل مع الدعم.
  • الفحوصات والتحليلات والتقارير. الفحص هو ما تجريه وتدفع مقابله: فحص صورة أو فحص مستند أو فحص نص. وفي API، التحليل هو فحص صورة أو مستند واحد، وعملية كشف النص هي فحص نص واحد. ينتج عن فحص الصور والمستندات تقرير كامل، وينتج عن فحص النص نتيجة.
  • الإصدارات. رقم الإصدار موجود في عنوان URL. يمكن إضافة حقول ونقاط نهاية جديدة إلى v1، لذا تجاهل الحقول التي لا تعرفها. يشير معرّف النموذج مثل fvimg-2 إلى نسخة مؤرَّخة (fvimg-2-2026-10-30). تُبيّن النتائج النسخة التي أنتجتها، ويمكنك تثبيت الطلب على نسخة مؤرَّخة بتمرير معرّفها في model.
  • اللغات. يقبل كشف النص: الإنجليزية (en) والفرنسية (fr) والألمانية (de) والإسبانية (es) والصينية (zh).

مواصفات OpenAPI

تُوصَف الواجهة بوثيقة OpenAPI 3.1 على العنوان https://api.fileverity.com/v1/openapi.json. ويُولَّد مرجع API من تلك الوثيقة، فيتطابق الاثنان دائمًا. ويمكن تحميل الوثيقة من متصفح، لذلك تستطيع أدوات مثل Swagger UI وPostman استيرادها عبر عنوان URL، ويعيد GET https://api.fileverity.com/v1 روابط إلى هذا التوثيق وإلى المواصفات.

محتويات هذا التوثيق

الفحوصات نفسها في المتصفح

لا تحتاج إلى API لإجراء فحص. يقدّم الموقع افحص صورة والتحقق من المستندات والتحقق من الصور، وتُجري لوحة التحكم الفحوصات الثلاثة كلها من رصيد مساحة عملك.

الدعم

راسل hello@fileverity.com أو استخدم صفحة التواصل، واذكر معرّف الطلب (x-request-id) والوقت بالتوقيت العالمي المنسق (UTC) ونقطة النهاية. تعيد حالات الفشل المؤقتة 503 service_unavailable مع ترويسة retry-after ولا تُحتسب عليها رسوم أبدًا. هل تحتاج إلى حدود أعلى أو تسعير بحسب الحجم؟ تواصل مع فريق المبيعات.

قراءة هذا التوثيق عبر وكيل ذكاء اصطناعي

تتوفر كل صفحة أيضًا بصيغة Markdown: أضف .md إلى مسارها، مثل /ar/docs/quickstart.md. وفهرس جميع الصفحات على /ar/docs/llms.txt.