Закриття PII на зображеннях — посібник із використання

Виявляйте та закривайте персональні дані на сканах, фотографіях і скріншотах. Цей посібник описує робочий процес завантаження, аналізу, закриття та завантаження результату, обмеження розміру та формату, підтримку мов 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 МБ); безкоштовний план взагалі не включає закриття PII на зображеннях.
Загальна роздільна здатність (ширина × висота) обмежена 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.

FAQ

Які формати зображень підтримуються?

Тільки PNG і JPG (JPEG). Інші растрові формати, такі як TIFF, BMP, WebP і GIF, наразі не підтримуються.

Які обмеження розміру та роздільної здатності?

20 МБ і 150 мегапікселів загальної роздільної здатності, а також додаткове обмеження ліміту завантаження вашого плану (5 МБ на Basic, 10 МБ на Pro, 20 МБ на 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