By · Last updated 2026-08-12

خانه/مستندات/breadcrumb.imageRedaction
بازگشت به مستندات

پنهان‌سازی PII در تصاویر — راهنمای استفاده

داده‌های شخصی درون اسکن‌ها، عکس‌ها و اسکرین‌شات‌ها را شناسایی و بپوشانید. این راهنما گردش کار بارگذاری، تحلیل، پنهان‌سازی و دانلود، محدودیت‌های اندازه و فرمت، پشتیبانی زبان OCR و فراخوانی API زیربنایی را پوشش می‌دهد.

گردش کار: بارگذاری، تحلیل، پنهان‌سازی، دانلود

هر تصویر همان چهار مرحله را طی می‌کند، چه از برنامه وب استفاده کنید، چه مستقیماً API را فراخوانی کنید، یا ابزار anonym_legal_redact_image را از طریق سرور MCP فراخوانی کنید.

۱. بارگذاری

یک فایل PNG یا JPG انتخاب کنید. پیش از ارسال هر چیزی به سرور، برنامه نوع و اندازه فایل را در برابر محدودیت بارگذاری پلن شما بررسی می‌کند.

۲. تحلیل

OCR (Tesseract) متن داخل تصویر را می‌خواند و ثبت می‌کند هر بخش از متن کجا قرار دارد. سپس این متن استخراج‌شده از همان تشخیص‌دهنده PII که برای اسناد استفاده می‌شود عبور می‌کند و موجودیت‌های یافت‌شده و موقعیت آنها را بازمی‌گرداند — هنوز چیزی پنهان نشده است.

۳. پنهان‌سازی

درخواست را دوباره با تنظیم mode روی "redact" اجرا کنید تا هر ناحیه شناسایی‌شده با یک جعبه مشکی توپر که مستقیماً روی پیکسل‌های تصویر کشیده می‌شود پوشانده شود. این یک پنهان‌سازی تصویری یک‌طرفه است، نه رمزگذاری برگشت‌پذیر.

۴. دانلود

تصویر پنهان‌شده به‌صورت یک فایل (PNG یا نوع محتوای اصلی) بازگردانده می‌شود که آن را به‌صورت محلی ذخیره می‌کنید — پس از ارسال پاسخ، چیزی روی سرور باقی نمی‌ماند.

محدودیت‌های اندازه و پیکسل

  • فقط PNG و JPG (JPEG) پشتیبانی می‌شوند. سایر فرمت‌های رستری مانند TIFF، BMP، WebP و GIF در حال حاضر پشتیبانی نمی‌شوند.
  • تصاویر در سمت سرور به ۲۰ مگابایت محدود شده‌اند. محدودیت پلن خود شما ممکن است پایین‌تر باشد — پلن Basic بارگذاری‌ها را به ۵ مگابایت محدود می‌کند (Pro با ۱۰ مگابایت، Business با ۲۰ مگابایت)؛ پلن رایگان اصلاً شامل پنهان‌سازی PII در تصاویر نمی‌شود.
  • رزولوشن کل (عرض × ارتفاع) به ۱۵۰ مگاپیکسل محدود شده است. بارگذاری‌های بالاتر از این حد پیش از پردازش رد می‌شوند.

پشتیبانی زبان 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 یا یک نشست احرازهویت‌شده، مشابه اندپوینت‌های تحلیل متن). درخواست‌های بدون توکن معتبر ۴۰۱ بازمی‌گردانند.

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 در حال حاضر پشتیبانی نمی‌شوند.

محدودیت‌های اندازه و رزولوشن چیست؟

۲۰ مگابایت و ۱۵۰ مگاپیکسل رزولوشن کل، که با محدودیت بارگذاری پلن خود شما بیشتر محدود می‌شود (۵ مگابایت در Basic، ۱۰ مگابایت در Pro، ۲۰ مگابایت در Business).

آیا پنهان‌سازی PII در تصاویر نیازمند پلن پولی است؟

بله. پنهان‌سازی PII در تصاویر نیازمند پلن Basic یا بالاتر است. پلن رایگان فقط ناشناس‌سازی متن را پشتیبانی می‌کند.

آیا این پنهان‌سازی برگشت‌پذیر است؟

خیر. پنهان‌سازی ناحیه شناسایی‌شده را مستقیماً روی پیکسل‌های تصویر با یک جعبه مشکی غیرشفاف می‌پوشاند — پنهان‌سازی تصویری یک‌طرفه، نه رمزگذاری برگشت‌پذیری که ناشناس‌ساز متن ارائه می‌دهد.

چگونه به‌جای استفاده از برنامه وب مستقیماً API را فراخوانی کنم؟

یک درخواست POST به آدرس /api/presidio/image با یک توکن Bearer در هدر Authorization و یک بدنه multipart/form-data شامل file و mode ("analyze" یا "redact") ارسال کنید. برای فهرست کامل فیلدها و شکل پاسخ، بخش مرجع API در بالا را ببینید.

پنهان‌سازی PII در تصاویر را امتحان کنید

یک اسکن، عکس یا اسکرین‌شات بارگذاری کنید و ببینید 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.