Szerző: George Curta ·
Képkitakarás — Használati útmutató
Észlelje és takarja el a személyes adatokat szkennelt dokumentumokon, fotókon és képernyőképeken belül. Ez az útmutató végigvezeti a feltöltés, elemzés, kitakarás és letöltés munkafolyamaton, a méret- és formátumkorlátokon, az OCR nyelvtámogatáson, valamint a mögöttes API-híváson.
Munkafolyamat: feltöltés, elemzés, kitakarás, letöltés
Minden kép ugyanazon a négy lépésen megy keresztül, akár a webalkalmazást használja, akár közvetlenül hívja az API-t, akár az anonym_legal_redact_image eszközt hívja meg az MCP szerveren keresztül.
1. Feltöltés
Válasszon egy PNG vagy JPG fájlt. Az alkalmazás a szerverre küldés előtt ellenőrzi a fájltípust és -méretet a csomagja feltöltési korlátjához képest.
2. Elemzés
Az OCR (Tesseract) beolvassa a képen lévő szöveget, és rögzíti az egyes szövegrészek helyét. A kinyert szöveg ezután ugyanazon a PII-detektoron megy keresztül, amelyet a dokumentumokhoz is használunk, visszaadva a talált entitásokat és pozícióikat — még semmi sem lett kitakarva.
3. Kitakarás
Futtassa újra a kérést "redact" módban, hogy minden észlelt régiót tömör fekete doboz takarjon el, közvetlenül a kép pixeleire rajzolva. Ez egyirányú, vizuális kitakarás, nem visszafordítható titkosítás.
4. Letöltés
A kitakart kép fájlként érkezik vissza (PNG vagy az eredeti tartalomtípus), amelyet helyben menthet — a válasz elküldése után semmi sem marad a szerveren.
Méret- és pixelkorlátok
- Csak PNG és JPG (JPEG) támogatott. Más raszteres formátumok, mint a TIFF, BMP, WebP és GIF, jelenleg nem támogatottak.
- A képek szerveroldali korlátja 20 MB. A csomagja saját korlátja lehet ennél alacsonyabb — a Basic csomag 5 MB-ra korlátozza a feltöltéseket (Pro 10 MB, Business 20 MB); az ingyenes csomag egyáltalán nem tartalmazza a képkitakarást.
- A teljes felbontás (szélesség × magasság) korlátja 150 megapixel. Az e fölötti feltöltéseket a rendszer feldolgozás előtt elutasítja.
OCR nyelvi támogatás
Az OCR a Tesseractra épül. Az API nyelvi mezője egy ISO 639-1 kódot fogad el (alapértelmezetten "en", azaz angol), amely egy Tesseract nyelvi csomaghoz van hozzárendelve — körülbelül három tucat nyelv van feltérképezve, köztük a német, francia, spanyol, olasz, portugál, holland, lengyel, orosz, ukrán, arab, héber, hindi, japán, koreai, kínai, thai, vietnami és török. A tényleges elérhetőség attól függ, mely Tesseract csomagok vannak telepítve az OCR-kiszolgálón; egy nem elérhető nyelv esetén a rendszer angolra vált vissza.
API referencia
A képkitakarás közvetlenül elérhető az API-n keresztül azoknak az integrációknak, amelyek nem a webalkalmazáson mennek keresztül, valamint az MCP szerveren keresztül az anonym_legal_redact_image eszközként ("analyze" vagy "redact" módban) az olyan MCP kliensek számára, mint a Claude.
POST /api/presidio/imageAuthentication: Hitelesítés Bearer tokennel az Authorization fejlécben (API token vagy hitelesített munkamenet, ugyanúgy, mint a szövegelemző végpontoknál). Az érvényes token nélküli kérések 401-es választ adnak.
Request body: Küldjön egy multipart/form-data törzset. Kötelező mezők: file (a PNG vagy JPG kép) és mode ("analyze" vagy "redact"). Opcionális mezők: language (ISO 639-1 OCR nyelvi kód, alapértelmezett "en"), entities (a JSON tömb az entitástípusok korlátozásához), score_threshold és fill_color (csak redact módban, alapértelmezett "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: Analyze módban a válasz JSON: a felismert entitások (típus, szövegpozíció és megbízhatósági pontszám), valamint egy tokens_charged mező. Redact módban a válasz maga a kitakart kép (bináris, Content-Type image/png vagy az eredeti típus), a tokenköltség pedig az X-Tokens-Charged fejlécben érkezik.
GYIK
Mely képformátumok támogatottak?
Csak PNG és JPG (JPEG). Más raszteres formátumok, mint a TIFF, BMP, WebP és GIF, jelenleg nem támogatottak.
Mik a méret- és felbontáskorlátok?
20 MB és 150 megapixel teljes felbontás, amelyet tovább korlátoz a csomagja saját feltöltési korlátja (5 MB Basic, 10 MB Pro, 20 MB Business esetén).
A képkitakarás fizetős csomagot igényel?
Igen. A képkitakaráshoz Basic vagy magasabb szintű csomag szükséges. Az ingyenes csomag csak szövegek anonimizálását támogatja.
Visszafordítható a kitakarás?
Nem. A kitakarás egy átlátszatlan fekete dobozzal takarja el az észlelt régiót közvetlenül a kép pixeleire — ez egyirányú, vizuális kitakarás, nem visszafordítható titkosítás, mint amilyet a szöveges anonimizáló kínál.
Hogyan hívhatom közvetlenül az API-t a webalkalmazás használata helyett?
Küldjön egy POST kérést a /api/presidio/image végpontra Bearer tokennel az Authorization fejlécben, valamint egy multipart/form-data törzzsel, amely tartalmazza a file és mode ("analyze" vagy "redact") mezőket. A teljes mezőlistáért és a válasz formátumáért lásd a fenti API referencia szakaszt.
Próbálja ki a képkitakarást
Töltsön fel egy szkennelt dokumentumot, fotót vagy képernyőképet, és néhány másodperc alatt lássa a kitakart PII-t.
Webalkalmazás megnyitásaLimitations / 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.