Затъмняване на изображения — Ръководство за употреба

Открийте и покрийте лични данни в сканирания, снимки и скрийншоти. Това ръководство преминава през работния процес на качване, анализ, затъмняване и изтегляне, лимитите за размер и формат, поддръжката на 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