Ukrywanie danych na obrazach — przewodnik użytkowania

Wykrywaj i zakrywaj dane osobowe wewnątrz skanów, zdjęć i zrzutów ekranu. Ten przewodnik omawia przepływ przesyłania, analizy, ukrywania i pobierania, limity rozmiaru i formatu, wsparcie językowe OCR oraz leżące u podstaw wywołanie API.

Otwórz aplikację webową Feature overview

Przepływ pracy: prześlij, przeanalizuj, ukryj, pobierz

Każdy obraz przechodzi przez te same cztery kroki, niezależnie od tego, czy korzystasz z aplikacji webowej, wywołujesz API bezpośrednio, czy wywołujesz narzędzie anonym_legal_redact_image za pośrednictwem serwera MCP.

1. Prześlij

Wybierz plik PNG lub JPG. Aplikacja sprawdza typ i rozmiar pliku względem limitu przesyłania Twojego planu, zanim cokolwiek zostanie wysłane na serwer.

2. Przeanalizuj

OCR (Tesseract) odczytuje tekst na obrazie i zapisuje, gdzie znajduje się każdy fragment tekstu. Ten wyodrębniony tekst jest następnie przepuszczany przez ten sam detektor PII, który jest używany dla dokumentów, zwracając znalezione jednostki i ich pozycje — nic nie jest jeszcze ukrywane.

3. Ukryj

Uruchom ponownie żądanie z trybem ustawionym na "redact", aby zakryć każdy wykryty obszar jednolitym czarnym prostokątem narysowanym bezpośrednio na pikselach obrazu. Jest to jednokierunkowe ukrycie wizualne, a nie odwracalne szyfrowanie.

4. Pobierz

Obraz z ukrytymi danymi jest zwracany jako plik (PNG lub oryginalny typ zawartości), który zapisujesz lokalnie — nic nie jest przechowywane na serwerze po wysłaniu odpowiedzi.

Limity rozmiaru i pikseli

Obsługiwane są tylko PNG i JPG (JPEG). Inne formaty rastrowe, takie jak TIFF, BMP, WebP i GIF, nie są obecnie obsługiwane.
Obrazy są ograniczone do 20 MB po stronie serwera. Limit Twojego planu może być niższy — plan Basic ogranicza przesyłanie do 5 MB (Pro 10 MB, Business 20 MB); plan darmowy nie obejmuje w ogóle ukrywania danych na obrazach.
Całkowita rozdzielczość (szerokość × wysokość) jest ograniczona do 150 megapikseli. Przesyłanie powyżej tego limitu jest odrzucane przed przetwarzaniem.

Wsparcie językowe OCR

OCR działa na Tesseract. Pole language w API akceptuje kod ISO 639-1 (domyślnie "en" dla angielskiego) mapowany na pakiet językowy Tesseract — zmapowanych jest około trzydziestu kilku języków, w tym niemiecki, francuski, hiszpański, włoski, portugalski, niderlandzki, polski, rosyjski, ukraiński, arabski, hebrajski, hindi, japoński, koreański, chiński, tajski, wietnamski i turecki. Rzeczywista dostępność zależy od tego, które pakiety Tesseract są zainstalowane na hoście OCR; niedostępny język przełącza się na angielski.

Dokumentacja API

Ukrywanie danych na obrazach jest dostępne bezpośrednio przez API dla integracji, które nie korzystają z aplikacji webowej, a także za pośrednictwem serwera MCP jako narzędzie anonym_legal_redact_image (tryb "analyze" lub "redact") dla klientów MCP, takich jak Claude.

POST /api/presidio/image

Authentication: Uwierzytelnij się za pomocą tokena Bearer w nagłówku Authorization (token API lub uwierzytelniona sesja, tak samo jak w przypadku punktów końcowych analizy tekstu). Żądania bez ważnego tokena zwracają 401.

Request body: Wyślij treść multipart/form-data. Wymagane pola: file (obraz PNG lub JPG) i mode ("analyze" lub "redact"). Opcjonalne pola: language (kod języka OCR ISO 639-1, domyślnie "en"), entities (tablica JSON typów jednostek, do których ma być ograniczone wykrywanie), score_threshold i fill_color (tylko tryb redact, domyślnie "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: W trybie analyze odpowiedź to JSON: wykryte jednostki (typ, pozycja tekstu i wynik pewności) oraz pole tokens_charged. W trybie redact odpowiedzią jest sam obraz z ukrytymi danymi (binarny, Content-Type image/png lub oryginalny typ) z kosztem tokenów zwróconym w nagłówku X-Tokens-Charged.

FAQ

Jakie formaty obrazów są obsługiwane?

Tylko PNG i JPG (JPEG). Inne formaty rastrowe, takie jak TIFF, BMP, WebP i GIF, nie są obecnie obsługiwane.

Jakie są limity rozmiaru i rozdzielczości?

20 MB i 150 megapikseli całkowitej rozdzielczości, dodatkowo ograniczone przez limit przesyłania Twojego planu (5 MB w Basic, 10 MB w Pro, 20 MB w Business).

Czy ukrywanie danych na obrazach wymaga płatnego planu?

Tak. Ukrywanie danych na obrazach wymaga planu Basic lub wyższego. Plan darmowy obsługuje tylko anonimizację tekstu.

Czy ukrycie jest odwracalne?

Nie. Ukrywanie zakrywa wykryty obszar nieprzezroczystym czarnym prostokątem bezpośrednio na pikselach obrazu — to jednokierunkowe ukrycie wizualne, a nie odwracalne szyfrowanie, jakie oferuje anonimizator tekstu.

Jak mogę wywołać API bezpośrednio zamiast korzystać z aplikacji webowej?

Wyślij żądanie POST do /api/presidio/image z tokenem Bearer w nagłówku Authorization i treścią multipart/form-data zawierającą file i mode ("analyze" lub "redact"). Zobacz sekcję dokumentacji API powyżej, aby uzyskać pełną listę pól i kształt odpowiedzi.

Wypróbuj ukrywanie danych na obrazach

Prześlij skan, zdjęcie lub zrzut ekranu i zobacz wykryte PII zakryte w kilka sekund.

Otwórz aplikację webową

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