Začernění obrázků — Uživatelský průvodce

Detekujte a zakryjte osobní údaje uvnitř skenů, fotografií a snímků obrazovky. Tento průvodce popisuje pracovní postup nahrání, analýzy, začernění a stažení, limity velikosti a formátu, podporu jazyků OCR a základní volání API.

Otevřít webovou aplikaci Feature overview

Pracovní postup: nahrát, analyzovat, začernit, stáhnout

Každý obrázek prochází stejnými čtyřmi kroky, ať už použijete webovou aplikaci, voláte API přímo, nebo vyvoláte nástroj anonym_legal_redact_image přes MCP server.

1. Nahrání

Vyberte soubor PNG nebo JPG. Aplikace zkontroluje typ a velikost souboru vůči limitu nahrávání vašeho plánu ještě předtím, než cokoli odešle na server.

2. Analýza

OCR (Tesseract) přečte text v obrázku a zaznamená, kde se každý kus textu nachází. Tento extrahovaný text poté prochází stejným detektorem PII, jaký se používá pro dokumenty, a vrací nalezené entity a jejich pozice — zatím se nic neredigovalo.

3. Začernění

Spusťte požadavek znovu s režimem nastaveným na "redact", abyste zakryli každou detekovanou oblast plným černým boxem nakresleným přímo na pixely obrázku. Jde o jednosměrné vizuální začernění, ne o vratné šifrování.

4. Stažení

Začerněný obrázek je vrácen jako soubor (PNG nebo původní typ obsahu), který si uložíte lokálně — po odeslání odpovědi na serveru nic nezůstává.

Limity velikosti a rozlišení

Podporovány jsou pouze PNG a JPG (JPEG). Jiné rastrové formáty jako TIFF, BMP, WebP a GIF momentálně nejsou podporovány.
Obrázky jsou na straně serveru omezeny na 20 MB. Limit vašeho vlastního plánu může být nižší — plán Basic omezuje nahrávání na 5 MB (Pro 10 MB, Business 20 MB); bezplatný plán začernění obrázků vůbec neobsahuje.
Celkové rozlišení (šířka × výška) je omezeno na 150 megapixelů. Nahrávky nad tímto limitem jsou odmítnuty ještě před zpracováním.

Podpora jazyků OCR

OCR běží na Tesseractu. Pole language v API přijímá kód ISO 639-1 (výchozí je "en" pro angličtinu) namapovaný na jazykový balíček Tesseractu — namapováno je zhruba tři desítky jazyků, včetně němčiny, francouzštiny, španělštiny, italštiny, portugalštiny, holandštiny, polštiny, ruštiny, ukrajinštiny, arabštiny, hebrejštiny, hindštiny, japonštiny, korejštiny, čínštiny, thajštiny, vietnamštiny a turečtiny. Skutečná dostupnost závisí na tom, jaké jazykové balíčky Tesseractu jsou nainstalované na hostiteli OCR; nedostupný jazyk se přepne zpět na angličtinu.

Referenční příručka API

Začernění obrázků je dostupné přímo přes API pro integrace, které nejdou přes webovou aplikaci, a přes MCP server jako nástroj anonym_legal_redact_image (režim „analyze" nebo „redact") pro MCP klienty, jako je Claude.

POST /api/presidio/image

Authentication: Autentizujte se pomocí Bearer tokenu v hlavičce Authorization (API token nebo autentizovaná relace, stejně jako u koncových bodů pro analýzu textu). Požadavky bez platného tokenu vrací 401.

Request body: Odešlete tělo typu multipart/form-data. Povinná pole: file (obrázek PNG nebo JPG) a mode ("analyze" nebo "redact"). Volitelná pole: language (kód jazyka OCR podle ISO 639-1, výchozí "en"), entities (pole JSON s typy entit, na které se má detekce omezit), score_threshold a fill_color (pouze v režimu redact, výchozí "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: V režimu analyze je odpovědí JSON: detekované entity (typ, pozice textu a hodnocení důvěryhodnosti) plus pole tokens_charged. V režimu redact je odpovědí samotný začerněný obrázek (binární, Content-Type image/png nebo původní typ) s cenou v tokenech vrácenou v hlavičce X-Tokens-Charged.

FAQ

Jaké formáty obrázků jsou podporovány?

Pouze PNG a JPG (JPEG). Jiné rastrové formáty jako TIFF, BMP, WebP a GIF momentálně nejsou podporovány.

Jaké jsou limity velikosti a rozlišení?

20 MB a celkové rozlišení 150 megapixelů, dále omezené limitem nahrávání vašeho vlastního plánu (5 MB na Basic, 10 MB na Pro, 20 MB na Business).

Vyžaduje začernění obrázků placený plán?

Ano. Začernění obrázků vyžaduje plán Basic nebo vyšší. Bezplatný plán podporuje pouze anonymizaci textu.

Je začernění vratné?

Ne. Začernění zakryje detekovanou oblast neprůhledným černým boxem přímo v pixelech obrázku — jde o jednosměrné vizuální začernění, ne o vratné šifrování, jaké nabízí textový anonymizátor.

Jak mohu volat API přímo místo použití webové aplikace?

Odešlete požadavek POST na /api/presidio/image s Bearer tokenem v hlavičce Authorization a tělem typu multipart/form-data obsahujícím file a mode ("analyze" nebo "redact"). Úplný seznam polí a tvar odpovědi najdete v části Referenční příručka API výše.

Vyzkoušejte začernění obrázků

Nahrajte sken, fotografii nebo snímek obrazovky a během několika sekund uvidíte zakrytou detekovanou PII.

Otevřít webovou aplikaci

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