Avtor: ·

Domov/Dokumentacija/Zakrivanje slik
Nazaj na dokumentacijo

Prikrivanje na slikah — vodnik za uporabo

Zaznajte in prekrijte osebne podatke na skeniranih dokumentih, fotografijah in posnetkih zaslona. Ta vodnik vodi skozi potek nalaganja, analize, prikrivanja in prenosa, omejitve velikosti in formata, podporo jezikov OCR ter osnovni klic API-ja.

Potek dela: nalaganje, analiza, prikrivanje, prenos

Vsaka slika gre skozi enake štiri korake, ne glede na to, ali uporabljate spletno aplikacijo, kličete API neposredno ali prek strežnika MCP uporabite orodje anonym_legal_redact_image.

1. Nalaganje

Izberite datoteko PNG ali JPG. Aplikacija pred pošiljanjem karkoli na strežnik preveri vrsto in velikost datoteke glede na omejitev nalaganja vašega načrta.

2. Analiza

OCR (Tesseract) prebere besedilo na sliki in zabeleži, kje se nahaja vsak del besedila. To izluščeno besedilo nato gre skozi isti detektor PII, ki se uporablja za dokumente, in vrne najdene entitete ter njihove položaje — nič še ni prikrito.

3. Prikrivanje

Znova zaženite zahtevo z načinom, nastavljenim na "redact", da prekrijete vsako zaznano območje s polnim črnim poljem, narisanim neposredno na slikovnih pikah slike. To je enosmerno vizualno prikrivanje, ne povratno šifriranje.

4. Prenos

Prikrita slika se vrne kot datoteka (PNG ali izvirna vrsta vsebine), ki jo shranite lokalno — po pošiljanju odgovora se na strežniku nič ne ohrani.

Omejitve velikosti in slikovnih pik

  • Podprta sta le PNG in JPG (JPEG). Drugi rastrski formati, kot so TIFF, BMP, WebP in GIF, trenutno niso podprti.
  • Slike so na strani strežnika omejene na 20 MB. Lastna omejitev vašega načrta je lahko nižja — načrt Basic omeji nalaganje na 5 MB (Pro 10 MB, Business 20 MB); brezplačni načrt sploh ne vključuje prikrivanja na slikah.
  • Skupna ločljivost (širina × višina) je omejena na 150 megapikslov. Nalaganja nad to omejitvijo so zavrnjena še pred obdelavo.

Podpora jezikov OCR

OCR deluje na Tesseractu. Polje jezika v API-ju sprejme kodo ISO 639-1 (privzeto "en" za angleščino), preslikano na jezikovni paket Tesseract — preslikanih je približno tri ducate jezikov, vključno z nemščino, francoščino, španščino, italijanščino, portugalščino, nizozemščino, poljščino, ruščino, ukrajinščino, arabščino, hebrejščino, hindijščino, japonščino, korejščino, kitajščino, tajščino, vietnamščino in turščino. Dejanska razpoložljivost je odvisna od tega, kateri paketi Tesseract so nameščeni na gostitelju OCR; nedosegljiv jezik se privzeto vrne na angleščino.

Referenca API

Zakrivanje slik je na voljo neposredno prek API-ja za integracije, ki ne potekajo prek spletne aplikacije, ter prek strežnika MCP kot orodje anonym_legal_redact_image (način "analyze" ali "redact") za odjemalce MCP, kot je Claude.

POST /api/presidio/image

Authentication: Avtenticirajte se z žetonom Bearer v glavi Authorization (API-žeton ali avtenticirana seja, enako kot pri končnih točkah za analizo besedila). Zahteve brez veljavnega žetona vrnejo 401.

Request body: Pošljite telo v obliki multipart/form-data. Obvezna polja: file (slika PNG ali JPG) in mode ("analyze" ali "redact"). Neobvezna polja: language (koda jezika OCR ISO 639-1, privzeto "en"), entities (polje JSON vrst entitet, na katere naj se omeji zaznavanje), score_threshold in fill_color (samo v načinu redact, privzeto "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: V načinu analyze je odgovor v obliki JSON: zaznane entitete (vrsta, položaj besedila in ocena zanesljivosti) ter polje tokens_charged. V načinu redact je odgovor kar prikrita slika (binarno, Content-Type image/png ali izvirna vrsta) s stroškom v žetonih, vrnjenim v glavi X-Tokens-Charged.

Pogosta vprašanja

Katere formate slik podpira?

Samo PNG in JPG (JPEG). Drugi rastrski formati, kot so TIFF, BMP, WebP in GIF, trenutno niso podprti.

Kakšne so omejitve velikosti in ločljivosti?

20 MB in skupna ločljivost 150 megapikslov, dodatno omejeno z lastno omejitvijo nalaganja vašega načrta (5 MB pri Basic, 10 MB pri Pro, 20 MB pri Business).

Ali prikrivanje na slikah zahteva plačljiv načrt?

Da. Prikrivanje na slikah zahteva načrt Basic ali višji. Brezplačni načrt podpira samo anonimizacijo besedila.

Ali je prikrivanje mogoče razveljaviti?

Ne. Prikrivanje prekrije zaznano območje z neprosojnim črnim poljem neposredno na slikovnih pikah slike — gre za enosmerno vizualno prikrivanje, ne za povratno šifriranje, kakršno ponuja anonimizator besedila.

Kako pokličem API neposredno namesto uporabe spletne aplikacije?

Pošljite zahtevo POST na /api/presidio/image z žetonom Bearer v glavi Authorization in telesom multipart/form-data, ki vsebuje file in mode ("analyze" ali "redact"). Za popoln seznam polj in obliko odgovora glejte zgornji razdelek reference API.

Preizkusite prikrivanje na slikah

Naložite skeniran dokument, fotografijo ali posnetek zaslona in v nekaj sekundah si oglejte prekrite zaznane PII.

Odprite spletno aplikacijo

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