Начало/Документация/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 MB на страна на сървъра. Собственият лимит на вашия план може да е по-нисък — план Basic ограничава качванията до 5 MB (Pro 10 MB, Business 20 MB); безплатният план изобщо не включва затъмняване на изображения.
Общата резолюция (широчина × височина) е ограничена до 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 MB и 150 мегапиксела обща резолюция, допълнително ограничени от собствения лимит за качване на вашия план (5 MB на Basic, 10 MB на Pro, 20 MB на 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.