بقلم George Curta ·
حجب الصور — دليل الاستخدام
اكتشف وغطِّ البيانات الشخصية داخل المستندات الممسوحة ضوئياً والصور ولقطات الشاشة. يشرح هذا الدليل سير عمل التحميل والتحليل والحجب والتنزيل، وحدود الحجم والصيغة، ودعم لغات OCR، واستدعاء API الأساسي.
سير العمل: تحميل، تحليل، حجب، تنزيل
تمر كل صورة بنفس الخطوات الأربع، سواء استخدمت تطبيق الويب أو استدعيت API مباشرة أو استدعيت أداة anonym_legal_redact_image عبر خادم MCP.
1. التحميل
اختر ملف PNG أو JPG. يتحقق التطبيق من نوع الملف وحجمه مقابل حد التحميل الخاص بخطتك قبل إرسال أي شيء إلى الخادم.
2. التحليل
يقرأ OCR (Tesseract) النص في الصورة ويسجل موضع كل جزء منه. ثم يُشغَّل هذا النص المستخرج عبر نفس كاشف PII المستخدم للمستندات، ليُعيد الكيانات المكتشفة ومواضعها — لا شيء يُحجب بعد.
3. الحجب
أعد تشغيل الطلب مع ضبط mode على "redact" لتغطية كل منطقة مكتشفة بمربع أسود معتم يُرسم مباشرة على بكسلات الصورة. هذا حجب بصري أحادي الاتجاه، وليس تشفيراً قابلاً للعكس.
4. التنزيل
تُعاد الصورة المحجوبة كملف (PNG أو نوع المحتوى الأصلي) تحفظه محلياً — لا يُحتفظ بشيء على الخادم بعد إرسال الاستجابة.
حدود الحجم والبكسل
- يُدعم فقط PNG وJPG (JPEG). صيغ رسومية أخرى مثل TIFF وBMP وWebP وGIF غير مدعومة حالياً.
- الصور محدودة بـ 20 ميغابايت من جانب الخادم. قد يكون حد خطتك أقل من ذلك — تحدد خطة Basic التحميل بـ 5 ميغابايت (Pro بـ 10 ميغابايت، Business بـ 20 ميغابايت)؛ لا تتضمن الخطة المجانية حجب الصور على الإطلاق.
- إجمالي الدقة (العرض × الارتفاع) محدود بـ 150 ميغابكسل. تُرفض التحميلات التي تتجاوز هذا الحد قبل المعالجة.
دعم لغات OCR
يعمل OCR على Tesseract. يقبل حقل language في API رمز ISO 639-1 (الافتراضي "en" للإنجليزية) المُطابَق لحزمة لغة Tesseract — يوجد حوالي ثلاث دزينات من اللغات المُطابَقة، بما في ذلك الألمانية والفرنسية والإسبانية والإيطالية والبرتغالية والهولندية والبولندية والروسية والأوكرانية والعربية والعبرية والهندية واليابانية والكورية والصينية والتايلاندية والفيتنامية والتركية. يعتمد التوفر الفعلي على حزم Tesseract المثبتة على خادم OCR؛ وتعود اللغة غير المتوفرة إلى الإنجليزية تلقائياً.
مرجع API
يتوفر حجب الصور مباشرة عبر API للتكاملات التي لا تمر عبر تطبيق الويب، وعبر خادم MCP كأداة anonym_legal_redact_image (بوضع "analyze" أو "redact") لعملاء MCP مثل Claude.
POST /api/presidio/imageAuthentication: صادق باستخدام رمز Bearer في ترويسة Authorization (رمز API أو جلسة مصادق عليها، مثل نقاط نهاية تحليل النص). الطلبات بدون رمز صالح تُعيد 401.
Request body: أرسل نصاً بصيغة multipart/form-data. الحقول المطلوبة: file (صورة PNG أو JPG) وmode ("analyze" أو "redact"). الحقول الاختيارية: language (رمز لغة OCR بصيغة ISO 639-1، الافتراضي "en")، وentities (مصفوفة JSON بأنواع الكيانات لتقييد الاكتشاف بها)، وscore_threshold، وfill_color (في وضع redact فقط، الافتراضي "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: في وضع analyze تكون الاستجابة بصيغة JSON: الكيانات المكتشفة (النوع وموضع النص ودرجة الثقة) بالإضافة إلى حقل tokens_charged. في وضع redact تكون الاستجابة هي الصورة المحجوبة نفسها (ثنائية، Content-Type من نوع image/png أو النوع الأصلي) مع إعادة تكلفة الرموز في ترويسة X-Tokens-Charged.
الأسئلة الشائعة
ما صيغ الصور المدعومة؟
PNG وJPG (JPEG) فقط. صيغ رسومية أخرى مثل TIFF وBMP وWebP وGIF غير مدعومة حالياً.
ما حدود الحجم والدقة؟
20 ميغابايت و150 ميغابكسل كإجمالي دقة، مع حد إضافي وفق حد التحميل الخاص بخطتك (5 ميغابايت في Basic، 10 ميغابايت في Pro، 20 ميغابايت في Business).
هل يتطلب حجب الصور خطة مدفوعة؟
نعم. يتطلب حجب الصور خطة Basic أو أعلى. تدعم الخطة المجانية تعقيم النص فقط.
هل الحجب قابل للعكس؟
لا. يغطي الحجب المنطقة المكتشفة بمربع أسود معتم مباشرة على بكسلات الصورة — حجب بصري أحادي الاتجاه، وليس تشفيراً قابلاً للعكس كما يوفره مُعقِّم النصوص.
كيف أستدعي API مباشرة بدلاً من استخدام تطبيق الويب؟
أرسل طلب POST إلى /api/presidio/image مع رمز Bearer في ترويسة Authorization وجسم طلب بصيغة multipart/form-data يحتوي على file وmode ("analyze" أو "redact"). راجع قسم مرجع API أعلاه للحصول على قائمة الحقول الكاملة وشكل الاستجابة.
جرّب حجب الصور
حمّل مستنداً ممسوحاً ضوئياً أو صورة أو لقطة شاشة وشاهد PII المكتشفة تُغطى في ثوانٍ.
افتح تطبيق الويبLimitations / Important note
- OCR-based text extraction is probabilistic; low-quality scans and handwriting lower detection recall.
- Redaction is a visual, one-way black box over the detected region — not reversible encryption.
- This page is informational and is not legal advice.