Од George Curta ·
Заматување на Слики — Водич за Употреба
Откријте и покријте лични податоци внатре во скенирања, фотографии и скриншотови. Овој водич ве води низ работниот тек за качување, анализа, заматување и преземање, ограничувањата на големина и формат, поддршката за јазици за OCR, и основниот API повик.
Работен тек: качување, анализа, заматување, преземање
Секоја слика поминува низ истите четири чекори, без разлика дали користите веб-апликацијата, го повикувате API-то директно, или ја повикувате алатката anonym_legal_redact_image преку MCP серверот.
1. Качување
Изберете PNG или JPG датотека. Апликацијата го проверува типот и големината на датотеката во однос на лимитот за качување на вашиот план пред да испрати нешто до серверот.
2. Анализа
OCR (Tesseract) го чита текстот во сликата и ја запишува позицијата на секој дел од текстот. Тој извлечен текст потоа поминува низ истиот детектор на PII користен за документи, враќајќи ги пронајдените ентитети и нивните позиции — сè уште ништо не е заматено.
3. Заматување
Повторно извршете го барањето со режимот поставен на "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. Полето за јазик на 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 (ISO 639-1 код на јазик за OCR, стандардно "en"), entities (JSON низа на типови на ентитети на кои да се ограничи детекцијата), score_threshold и fill_color (само за режим на заматување, стандардно "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: Во режим на анализа одговорот е JSON: детектираните ентитети (тип, позиција на текстот и оценка на доверба) плус поле tokens_charged. Во режим на заматување одговорот е самата заматена слика (бинарна, 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.