الرئيسية/التوثيق/breadcrumb.imageRedaction

حجب الصور — دليل الاستخدام

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

افتح تطبيق الويب Feature overview

سير العمل: تحميل، تحليل، حجب، تنزيل

تمر كل صورة بنفس الخطوات الأربع، سواء استخدمت تطبيق الويب أو استدعيت 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/image

Authentication: صادق باستخدام رمز 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.

How we measure — our methodology

About this page

We update this page when our platform or the law changes.

Read our founder note for how we work.

Each change shows up in the timestamp at the top.

We follow these rules

GDPR (EU 2016/679).
ISO/IEC 27001:2022, held by our hosting provider.
NIS2 (EU 2022/2555).
HIPAA safe harbor under 45 CFR § 164.514(b)(2).

Our promise

We do not sell your data.

We do not train models on your text.

We store your files in Germany.

You can delete your account at any time.

You own your work.

Where we run

Our company HQ is in Saarbrücken, Germany. Our servers run in Hetzner's Falkenstein datacenter.

Hetzner holds ISO 27001 certification.

All data stays in the EU.

Backups run every day.

Need help?

Email support@anonym.legal.

We reply within one business day.

How we test

Automated checks run on every release.

Each surface gets its own sweep script and report.

Human reviewers spot-check the output each week.

We test detection against sample documents before each release.

A failing unit or integration run stops the release.

What we never do

We never sell your information to third parties.
We never train models on what you upload.
We never keep your work after you delete it.
We never share keys with any outside firm.
We never run ads inside the product.

Plans in plain words

We sell credits, not seats.

One credit covers one short job.

Long jobs use a few credits each.

Paid plans can buy top-up credits.

Credits reset at the end of each cycle.

Read the plans page for current rates.

Who built this

A small team of engineers and lawyers built this.

We ship from Europe and work in the open.

Our founder note spells out why we started.

Where to start

How the parts fit

A browser add-on cleans text inside Chrome.

A Word plug-in handles drafts in Office.

A small desktop tool works on whole folders.

An agent protocol link feeds large models safely.

All four share one core engine and one rule set.

Words from our team

We started this work after a lunch about cookies.

One friend kept getting odd ads on her phone.

We asked why a court file leaked through a draft.

We sketched the first build on a napkin that week.

By month three we had a tiny demo for a friend.

She used it on her first case the next day.

Common questions we hear

Can the tool read scanned PDFs? Yes, with OCR.

Does it work on long files? Yes, in small chunks.

Can I roll my own rule set? Yes, save it as a preset.

Does it run offline? The desktop build runs offline.

Do you keep my files? No, the cloud build wipes after each run.

Will it learn from my work? No, we never train on inputs.

A short tour of the workflow

Upload a file or paste a snippet of prose.

Pick the entities you want gone from the draft.

Choose a method: replace, mask, hash, encrypt, or redact.

Press run and watch the side panel show each hit.

Skim the result and tweak any rule that misfired.

Save the cleaned file or send it to a teammate.