كشف النصوص

يُجري POST /text/detections فحص نص واحد. يصنّف النص العادي بنموذج fvdoc-3-text ويعيد الفقرات المكتوبة بالذكاء الاصطناعي. وهو متزامن: النتيجة في الاستجابة نفسها.

تقرأ الأمثلة النص من ملف، لذا احفظ أي فقرة من 100 كلمة أو أكثر باسم essay.txt أولًا. ويتضمن البدء السريع أمرًا يكتب نصًا تجريبيًا.

curl https://api.fileverity.com/v1/text/detections \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 6b9d1c1e-3b0f-4c0a-9a53-2d1c9d6b7e11" \  -d "$(jq -Rs '{text: ., language: "en"}' essay.txt)"

import { readFile } from "node:fs/promises";import { randomUUID } from "node:crypto"; const response = await fetch("https://api.fileverity.com/v1/text/detections", {  method: "POST",  headers: {    Authorization: "Bearer " + process.env.FILEVERITY_API_KEY,    "Content-Type": "application/json",    "Idempotency-Key": randomUUID(),  },  body: JSON.stringify({ text: await readFile("essay.txt", "utf8"), language: "en" }),});const detection = await response.json();

import osimport uuidimport requests response = requests.post(    "https://api.fileverity.com/v1/text/detections",    headers={        "Authorization": "Bearer " + os.environ["FILEVERITY_API_KEY"],        "Idempotency-Key": str(uuid.uuid4()),    },    json={"text": open("essay.txt", encoding="utf-8").read(), "language": "en"},)detection = response.json()

محتوى الطلب#

تُرفض الحقول غير المعروفة برمز الخطأ invalid_parameter. وعند التحقق من الحد الأدنى البالغ 100 كلمة، يُحتسب كل حرفين صينيين تقريبًا ككلمة واحدة.

الاستجابة#

{  "id": "tdet_8Hk2pQ4vN9sL1xR7cW3mY6zB",  "object": "text.detection",  "created": 1793664000,  "model": "fvdoc-3-text-2026-11-03",  "livemode": true,  "language": "en",  "verdict": "mixed",  "score": 0.97,  "ai_fraction": 0.41,  "segments": [    {      "start": 212,      "end": 433,      "score": 0.97    },    {      "start": 579,      "end": 790,      "score": 0.93    }  ],  "usage": {    "characters": 1412,    "free_characters": 0,    "billed_units": 2  }}

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

إزاحات المقاطع#

start وend إزاحتان في النص الذي أرسلته، تُحسبان بنقاط ترميز Unicode، لا بالبايتات ولا بوحدات UTF-16. وحدود المقاطع تقريبية وقد تشمل جملًا مجاورة. تُفهرَس سلاسل JavaScript بوحدات UTF-16، لذا قسّم النص إلى نقاط ترميز أولًا:

const points = Array.from(text);for (const { start, end } of detection.segments) {  console.log(points.slice(start, end).join(""));}

for segment in detection["segments"]:    print(text[segment["start"]:segment["end"]])

تُفهرَس سلاسل Python أصلًا بنقاط الترميز.

الفوترة#

• يُحتسب النص بسعر ⁦US$ 0.14⁩ لكل 1,000 حرف، وتُعدّ الأحرف بنقاط ترميز Unicode. ويُقرَّب كل طلب إلى الأعلى إلى وحدات كاملة، بحد أدنى وحدة واحدة.
• تُستخدم أحرف النص المجانية من رصيد البدء المجاني أولًا، وتظهر في usage.free_characters. وusage.billed_units هو عدد الوحدات المحتسبة بعدها، فتكون التكلفة billed_units مضروبًا في ⁦US$ 0.14⁩. مثال: 1,412 حرفًا دون أحرف مجانية متبقية يُحتسب عليها وحدتان، أي ⁦US$ 0.28⁩.
• لا تُحتسب رسوم على الطلبات المرفوضة قبل التقييم: المعلمات غير الصالحة، والنص القصير جدًا أو الطويل جدًا، واللغات غير المدعومة وما شابه. وإذا فشل الفحص داخل الخدمة (service_unavailable) فيُحرَّر المبلغ المحجوز ولا يُحتسب عليك.
• عند عدم كفاية الرصيد يُعاد الخطأ insufficient_balance (402).

ما الذي يُخزَّن#

يُقيَّم النص ثم يُحذف. ولا يُخزَّن أبدًا، لذلك لا يمكن استرجاعه لاحقًا.

تحتفظ Fileverity بالنتيجة دون النص (الحكم والدرجات وإزاحات الفقرات والاستخدام) مدة 7 أيام، حتى تعرضها لوحة التحكم ويمكن احتساب الاستخدام وتدقيقه. ويحصل الطلب المُعاد الذي يحمل Idempotency-Key نفسه على النتيجة المحفوظة خلال 24 ساعة. عمليات كشف النصوص متزامنة: فلا تظهر في GET /analyses ولا تُرسل أحداث Webhook. ولا تسجّل مفاتيح الاختبار شيئًا. راجع الاحتفاظ بالبيانات والأمان.

الأخطاء#

أرسل Idempotency-Key حتى لا تؤدي إعادة المحاولة بعد انتهاء المهلة إلى احتساب الرسم مرتين. راجع Idempotency.