Začiernenie obrázkov — Návod na použitie

Detegujte a prekryte osobné údaje v skenoch, fotografiách a screenshotoch. Tento návod prevedie cez pracovný postup nahrávania, analýzy, začiernenia a sťahovania, limity veľkosti a formátu, podporu jazykov OCR a základné volanie API.

Otvoriť webovú aplikáciu Feature overview

Pracovný postup: nahrávanie, analýza, začiernenie, sťahovanie

Každý obrázok prechádza rovnakými štyrmi krokmi, či už používate webovú aplikáciu, voláte API priamo, alebo vyvoláte nástroj anonym_legal_redact_image cez MCP server.

1. Nahranie

Vyberte súbor PNG alebo JPG. Aplikácia skontroluje typ a veľkosť súboru voči limitu nahrávania vášho plánu skôr, ako čokoľvek odošle na server.

2. Analýza

OCR (Tesseract) prečíta text v obrázku a zaznamená, kde sa nachádza každá časť textu. Tento extrahovaný text potom prechádza rovnakým detektorom PII, aký sa používa pre dokumenty, a vráti nájdené entity a ich pozície — zatiaľ sa nič neredigovalo.

3. Začiernenie

Znovu spustite požiadavku s režimom nastaveným na "redact", aby sa každá detegovaná oblasť prekryla plnou čiernou plochou nakreslenou priamo na pixeloch obrázka. Ide o jednosmerné vizuálne začiernenie, nie o reverzibilné šifrovanie.

4. Stiahnutie

Zredigovaný obrázok sa vráti ako súbor (PNG alebo pôvodný typ obsahu), ktorý si uložíte lokálne — po odoslaní odpovede sa na serveri nič nezachováva.

Limity veľkosti a pixelov

Podporované sú iba PNG a JPG (JPEG). Ďalšie rastrové formáty ako TIFF, BMP, WebP a GIF momentálne nie sú podporované.
Obrázky sú na strane servera obmedzené na 20 MB. Vlastný limit vášho plánu môže byť nižší — plán Basic obmedzuje nahrávanie na 5 MB (Pro 10 MB, Business 20 MB); bezplatný plán vôbec nezahŕňa začiernenie obrázkov.
Celkové rozlíšenie (šírka × výška) je obmedzené na 150 megapixelov. Nahrávania nad tento limit sú odmietnuté ešte pred spracovaním.

Podpora jazykov OCR

OCR beží na Tesseract. Pole jazyka v API akceptuje kód ISO 639-1 (predvolene "en" pre angličtinu) namapovaný na jazykový balík Tesseract — namapovaných je približne tri desiatky jazykov, vrátane nemčiny, francúzštiny, španielčiny, taliančiny, portugalčiny, holandčiny, poľštiny, ruštiny, ukrajinčiny, arabčiny, hebrejčiny, hindčiny, japončiny, kórejčiny, čínštiny, thajčiny, vietnamčiny a turečtiny. Skutočná dostupnosť závisí od toho, ktoré balíky Tesseract sú nainštalované na OCR hostiteľovi; nedostupný jazyk sa vráti späť na angličtinu.

Referencia API

Začiernenie obrázkov je dostupné priamo cez API pre integrácie, ktoré neprechádzajú cez webovú aplikáciu, a cez MCP server ako nástroj anonym_legal_redact_image (režim „analyze" alebo „redact") pre MCP klientov ako Claude.

POST /api/presidio/image

Authentication: Autentifikujte sa pomocou Bearer tokenu v hlavičke Authorization (API token alebo autentifikovaná relácia, rovnako ako pri endpointoch analýzy textu). Požiadavky bez platného tokenu vrátia 401.

Request body: Odošlite telo vo formáte multipart/form-data. Povinné polia: file (obrázok PNG alebo JPG) a mode ("analyze" alebo "redact"). Voliteľné polia: language (kód jazyka OCR ISO 639-1, predvolene "en"), entities (JSON pole typov entít, na ktoré sa detekcia obmedzí), score_threshold a fill_color (iba v režime redact, predvolene "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: V režime analyze je odpoveďou JSON: zistené entity (typ, pozícia v texte a skóre istoty) plus pole tokens_charged. V režime redact je odpoveďou samotný začiernený obrázok (binárne, Content-Type image/png alebo pôvodný typ) s cenou v tokenoch vrátenou v hlavičke X-Tokens-Charged.

Časté otázky

Aké formáty obrázkov sú podporované?

Iba PNG a JPG (JPEG). Ďalšie rastrové formáty ako TIFF, BMP, WebP a GIF momentálne nie sú podporované.

Aké sú limity veľkosti a rozlíšenia?

20 MB a celkové rozlíšenie 150 megapixelov, ďalej obmedzené vlastným limitom nahrávania vášho plánu (5 MB na Basic, 10 MB na Pro, 20 MB na Business).

Vyžaduje začiernenie obrázkov platený plán?

Áno. Začiernenie obrázkov vyžaduje plán Basic alebo vyšší. Bezplatný plán podporuje iba anonymizáciu textu.

Je začiernenie reverzibilné?

Nie. Začiernenie prekrýva detegovanú oblasť nepriehľadnou čiernou plochou priamo na pixeloch obrázka — ide o jednosmerné vizuálne začiernenie, nie o reverzibilné šifrovanie, aké ponúka textový anonymizér.

Ako môžem volať API priamo namiesto použitia webovej aplikácie?

Odošlite požiadavku POST na /api/presidio/image s Bearer tokenom v hlavičke Authorization a telom vo formáte multipart/form-data obsahujúcim file a mode ("analyze" alebo "redact"). Úplný zoznam polí a tvar odpovede nájdete v časti referencia API vyššie.

Vyskúšajte začiernenie obrázkov

Nahrajte sken, fotografiu alebo screenshot a za pár sekúnd uvidíte detegované PII prekryté.

Otvoriť webovú aplikáciu

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