ForHosting KIT · المستندات وملفات PDF

علّموا صفحات PDF التي تحتاج OCR

حدّد أربع صفحات بأنها نص ثم صورة ثم نص ثم صورة، فتعرف أن الصفحتين 2 و4 تحتاجان إلى OCR وأن الصفحتين 1 و3 قابلتان للبحث، مع ملخص قصير. أرسل هذه الصفحات وحدها إلى التعرف الضوئي. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تجمع ملفات PDF كثيرة بين صفحات رقمية أصلية تحمل بالفعل طبقة نص قابلة للتحديد وصفحات ممسوحة ضوئيًا تبدو سليمة على الشاشة لكنها لا تتيح النسخ أو البحث أو الفهرسة. قبل إنفاق الميزانية على OCR للمستند كله أو إرسال الملف إلى مسار يفترض وجود نص قابل للاستخراج، تحتاجون قائمة دقيقة بأرقام الصفحات التي تفتقر إلى طبقة النص. تقبل هذه القدرة خريطة الحضور المنطقية—true عندما تحتوي الصفحة على نص قابل للاستخراج، وfalse عندما تكون صورة فقط—وتعيد الصفحات التي تحتاج OCR، والصفحات القابلة للبحث بالفعل، والعدادات، ونسبة OCR، وملخصًا في سطر واحد. تُرفض المدخلات الفارغة حتى لا يُحسب الصمت نجاحًا.

معنى أعلام طبقة النص وأهمية OCR على مستوى الصفحة

قد ترسم صفحة PDF حروفًا تبدو كنص بينما تخزّن تحتها صورة نقطية فقط. تتلقى الأدوات اللاحقة التي تستدعي واجهات استخراج النص سلاسل فارغة، ويتخطى البحث النصي الكامل الصفحة، ولا يعلن قرّاء إمكانية الوصول شيئًا مفيدًا، وتفشل مسارات الأرشفة التي تتوقع نصًا أصليًا بصمت. العلاج العملي هو OCR، لكن تشغيله على كل صفحة من مستند مختلط كبير يهدر الوقت والمال عندما يكون نصف الصفحات قد امتلك طبقة نص.

العقد هنا ضيق عمدًا: أنتم تعرفون مسبقًا—أو أن مجسًا خفيفًا قد قاس—ما إذا كانت كل صفحة تحمل نصًا قابلًا للاستخراج. تمرّرون تلك القائمة المرتبة من الأعلام المنطقية؛ ولا يفتح هذا المسار ملف PDF نفسه. تعني true أن الصفحة قابلة للبحث ولا تحتاج OCR؛ وتعني false أنها صورة فقط (أو بلا طبقة نص) ويجب وضعها في طابور OCR.

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

أين تثبت واجهة أعلام الصفحات التي تحتاج OCR قيمتها

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

أبقوا الطلبات صغيرة، وثبّتوا قوائم الصفحات المرتبة في الاختبارات، فتحصلون على بوابة قابلة لإعادة الإنتاج بين جرد PDF وإنفاق OCR دون بناء مكدس ذكاء اصطناعي للمستندات من أجل مسح منطقي بسيط.

حالات الاستخدام

قوائم عمل OCR انتقائية

حوّلوا مجس طبقة النص لكل صفحة إلى قائمة تبدأ من واحد للصفحات التي ما زالت تحتاج OCR حتى تتخطى المهام الدفعية الصفحات القابلة للبحث.

تذاكر إصلاح إمكانية الوصول

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

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

هل أرقام الصفحات تبدأ من صفر أم من واحد؟

من واحد، كما يعدّ الناس ومعظم واجهات PDF. العلم الأول هو الصفحة 1، والثاني الصفحة 2، وهكذا.

هل تفتح هذه القدرة ملف PDF أو تجري عليه OCR؟

لا. تحلل فقط أعلام طبقة النص المنطقية التي تقدّمونها.

ماذا تعني نسبة الصفحات التي تحتاج إلى OCR؟

هي الجزء من المستند الذي ما زال يحتاج إلى التعرف الضوئي: عدد الصفحات بلا نص مقسومًا على العدد الكلي. مع أربع صفحات منها اثنتان بلا نص تكون النسبة 0.5، أي نصف المستند.

لماذا قد تحتاج صفحة يظهر فيها نص إلى OCR؟

لأن ما تراه قد يكون صورة للنص فقط. تبدو الصفحات الممسوحة سليمة على الشاشة لكنها لا تحفظ إلا صورة، فلا يحصل النسخ أو البحث أو قارئ الشاشة على شيء منها.

ماذا يحدث إذا كانت قيمة إحدى الصفحات غير صالحة؟

يتوقف الفحص ويذكر تلك الصفحة مرقّمة بدءًا من واحد، لتصحح الخطوة التي أنتجت القائمة. وتُرفض القائمة الفارغة أيضًا حتى لا يُفهم الصمت على أنه نجاح.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/searchable-ocr-flag

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/searchable-ocr-flag \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text_layer":[true,false,true,false]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/searchable-ocr-flag", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text_layer": [
      true,
      false,
      true,
      false
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/searchable-ocr-flag",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text_layer": [
        true,
        false,
        true,
        false
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/searchable-ocr-flag", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text_layer":[true,false,true,false]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text_layer":[true,false,true,false]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/searchable-ocr-flag", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text_layer": [
    true,
    false,
    true,
    false
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.searchable_ocr_flag",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تعمل منطق parse الخالص نفسه مجانًا في أداة المتصفح وعلى مسار API، فلا تختلف فحوصات ما قبل التشغيل وأتمتة الإنتاج حول الصفحات التي يجب معالجتها بـ OCR.

معنى أعلام طبقة النص وأهمية OCR على مستوى الصفحة

تسرد الاستجابة needs_ocr_pages وsearchable_pages كأرقام صفحات تبدأ من واحد، إضافة إلى needs_ocr_count وsearchable_count وall_need_ocr وall_searchable وocr_ratio بوصفها needs_ocr_count مقسومة على page_count، ومصفوفة pages مع has_text_layer وneeds_ocr لكل صفحة، وsummary مقروءًا للسجلات وواجهات المستخدم.

عقد الإدخال وشكل الاستجابة وأخطاء القائمة الفارغة

ينبغي أن يكون كل عنصر منطقيًا؛ ويقبل الحل أيضًا الرموز الرقمية صفر وواحد والسلاسل الشائعة true وfalse وyes وno وy وn وzero وone حتى تُلصق صادرات CSV أو النماذج دون تحويل مسبق. تفشل الرموز غير الصالحة على صفحة محددة مع ذكر فهرس الصفحة من واحد حتى تصلحوا المجس الذي أنتج الخريطة. اقرنوا هذه المخرجات بمحرك OCR خاص بكم أو بمنتج OCR شقيق لملفات PDF عندما تكونون جاهزين لمعالجة الصفحات المدرجة فقط. أرسلوا جسم JSON يتضمن text_layer، وهو مصفوفة غير فارغة إلزامية لأعلام الحضور لكل صفحة بترتيب المستند. تُقبل الأسماء البديلة pages وflags وhas_text لنفس المصفوفة. تفشل المصفوفة الفارغة أو السلسلة البيضاء أو الحقل المفقود أو القيمة null بـ invalid_input مع رسالة تسمّي text_layer وتذكر أن علم صفحة واحدًا على الأقل مطلوب—ولا تُفوتر تلك الإخفاقات. عند النجاح يعيد الجسم page_count مساويًا لطول الأعلام، وneeds_ocr_pages لكل false، وsearchable_pages لكل true، والعدّادين، وall_need_ocr عندما تحتاج كل الصفحات OCR، وall_searchable عندما لا تحتاج أي منها، وocr_ratio مقربة إلى اثنتي عشرة منزلة عشرية لاختبارات مستقرة عبر بيئات التشغيل، ومصفوفة pages التفصيلية، وsummary. مثال: الأعلام true وfalse وtrue وfalse تعطي page_count أربعة، وneeds_ocr_pages اثنتين وأربع، وsearchable_pages واحدةًا وثلاث، وneeds_ocr_count اثنين، وocr_ratio صفر فاصلة خمسة، وملخصًا يقول إن صفحتين من أربع تحتاجان OCR.

أين تثبت واجهة أعلام الصفحات التي تحتاج OCR قيمتها

تستخدم منصات البحث وe-discovery الأعلام نفسها لتقرر إن كان المستند جاهزًا للفهرسة أم يجب أن ينتظر OCR، ويغذي الحقل ocr_ratio لوحات جودة تتابع كم من كل دفعة واردة ما زال صورة فقط. تستفيد مواقع المحتوى وSEO التي تستهدف عبارات مثل تعليم صفحات PDF التي تحتاج OCR من أداة مجانية حية يطابق وحدتها الخالصة مسار API بايتًا ببايت. ولأن التنفيذ من طبقة parse A، يكلف كل استدعاء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة؛ ولا يستهلك فشل التحقق الرصيد.

حالات التكامل

الاستقبال وجاهزية الفهرس

قرروا إن كان PDF مختلطًا جاهزًا للبحث النصي الكامل أم يجب أن ينتظر OCR باستخدام needs_ocr_count وocr_ratio في مساركم.

أسئلة تقنية

كيف نعلّم صفحات PDF التي تحتاج OCR؟

أرسلوا text_layer كمصفوفة منطقية غير فارغة بترتيب الصفحات (true = نص قابل للاستخراج، false = تحتاج OCR). تعيد API القيم needs_ocr_pages وsearchable_pages والعدادات وocr_ratio وsummary.

ماذا يحدث إذا كان text_layer فارغًا؟

تفشل المهمة بـ invalid_input. تُرفض قائمة الأعلام الفارغة أو المفقودة حتى لا يُفهم الصمت على أنه «لا صفحة تحتاج OCR». لا يُفوتر فشل التحقق.

كم يكلف تعليم صفحات PDF التي تحتاج OCR؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ ولا تُفوتر المدخلات غير الصالحة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

معنى أعلام طبقة النص وأهمية OCR على مستوى الصفحة

أين تثبت واجهة أعلام الصفحات التي تحتاج OCR قيمتها

حالات الاستخدام

قوائم عمل OCR انتقائية

تذاكر إصلاح إمكانية الوصول

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

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

معنى أعلام طبقة النص وأهمية OCR على مستوى الصفحة

عقد الإدخال وشكل الاستجابة وأخطاء القائمة الفارغة

أين تثبت واجهة أعلام الصفحات التي تحتاج OCR قيمتها

حالات التكامل

الاستقبال وجاهزية الفهرس

أسئلة تقنية

شكرًا