Kirjoittanut George Curta ·
Kuvien PII-peittäminen — Käyttöopas
Tunnista ja peitä henkilötietoja skannauksissa, valokuvissa ja kuvakaappauksissa. Tämä opas käy läpi lataus-, analysointi-, peittämis- ja latausvaiheiden työnkulun, koko- ja muotorajoitukset, OCR-kielituen sekä taustalla olevan API-kutsun.
Työnkulku: lataa, analysoi, peitä, lataa
Jokainen kuva käy läpi samat neljä vaihetta, käytitpä sitten verkkosovellusta, kutsuit API:a suoraan tai käytit anonym_legal_redact_image-työkalua MCP-palvelimen kautta.
1. Lataus
Valitse PNG- tai JPG-tiedosto. Sovellus tarkistaa tiedoston tyypin ja koon tasosi latausrajaa vasten ennen kuin mitään lähetetään palvelimelle.
2. Analysointi
OCR (Tesseract) lukee kuvan tekstin ja tallentaa, missä jokainen tekstinpätkä sijaitsee. Tämä erotettu teksti käy sitten läpi saman PII-tunnistimen, jota käytetään asiakirjoissa, ja palauttaa löydetyt entiteetit ja niiden sijainnit — mitään ei ole vielä peitetty.
3. Peittäminen
Suorita pyyntö uudelleen mode-arvolla "redact" peittääksesi jokaisen tunnistetun alueen yhtenäisellä mustalla laatikolla, joka piirretään suoraan kuvan pikseleihin. Tämä on yksisuuntainen visuaalinen peittäminen, ei palautettavaa salausta.
4. Lataus
Peitetty kuva palautetaan tiedostona (PNG tai alkuperäinen sisältötyyppi), jonka tallennat paikallisesti — mitään ei säilytetä palvelimella vastauksen lähettämisen jälkeen.
Koko- ja pikselirajat
- Vain PNG ja JPG (JPEG) ovat tuettuja. Muita rasterimuotoja, kuten TIFF, BMP, WebP ja GIF, ei tällä hetkellä tueta.
- Kuvat on rajoitettu 20 Mt:iin palvelinpuolella. Oma tasosi raja voi olla pienempi — Basic-taso rajoittaa lataukset 5 Mt:iin (Pro 10 Mt, Business 20 Mt); ilmaistaso ei sisällä kuvien PII-peittämistä lainkaan.
- Kokonaisresoluutio (leveys × korkeus) on rajoitettu 150 megapikseliin. Tämän rajan ylittävät lataukset hylätään ennen käsittelyä.
OCR-kielituki
OCR toimii Tesseractilla. APIn language-kenttä hyväksyy ISO 639-1 -koodin (oletuksena "en" englannille), joka on kartoitettu Tesseract-kielipakettiin — noin kolme tusinaa kieltä on kartoitettu, mukaan lukien saksa, ranska, espanja, italia, portugali, hollanti, puola, venäjä, ukraina, arabia, heprea, hindi, japani, korea, kiina, thai, vietnam ja turkki. Todellinen saatavuus riippuu siitä, mitkä Tesseract-paketit on asennettu OCR-palvelimelle; ei-saatavilla oleva kieli palautuu englantiin.
API-viite
Kuvien PII-mustaus on saatavilla suoraan API:n kautta integraatioille, jotka eivät kulje verkkosovelluksen kautta, sekä MCP-palvelimen kautta anonym_legal_redact_image-työkaluna (tila "analyze" tai "redact") MCP-asiakkaille kuten Claudelle.
POST /api/presidio/imageAuthentication: Todennus Bearer-tokenilla Authorization-otsikossa (API-token tai todennettu istunto, samoin kuin tekstianalyysin päätepisteissä). Pyynnöt ilman kelvollista tokenia palauttavat 401:n.
Request body: Lähetä multipart/form-data-runko. Pakolliset kentät: file (PNG- tai JPG-kuva) ja mode ("analyze" tai "redact"). Valinnaiset kentät: language (ISO 639-1 OCR-kielikoodi, oletuksena "en"), entities (JSON-taulukko entiteettityypeistä, joihin tunnistus rajataan), score_threshold ja fill_color (vain redact-tilassa, oletuksena "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: Analyze-tilassa vastaus on JSON: tunnistetut entiteetit (tyyppi, tekstin sijainti ja luottamuspisteet) sekä tokens_charged-kenttä. Redact-tilassa vastaus on itse peitetty kuva (binäärinen, Content-Type image/png tai alkuperäinen tyyppi), ja token-kustannus palautetaan X-Tokens-Charged-otsikossa.
Usein kysytyt kysymykset
Mitä kuvamuotoja tuetaan?
Vain PNG ja JPG (JPEG). Muita rasterimuotoja, kuten TIFF, BMP, WebP ja GIF, ei tällä hetkellä tueta.
Mitkä ovat koko- ja resoluutiorajat?
20 Mt ja 150 megapikseliä kokonaisresoluutiota, mitä oman tasosi latausraja rajoittaa edelleen (5 Mt Basicissa, 10 Mt Prossa, 20 Mt Businessissa).
Vaatiiko kuvien PII-peittäminen maksullisen tason?
Kyllä. Kuvien PII-peittäminen vaatii Basic-tason tai korkeamman. Ilmaistaso tukee vain tekstin anonymisointia.
Onko peittäminen palautettavissa?
Ei. Peittäminen peittää tunnistetun alueen läpinäkymättömällä mustalla laatikolla suoraan kuvan pikseleissä — yksisuuntainen visuaalinen peittäminen, ei palautettavaa salausta, jota tekstin anonymisoija tarjoaa.
Miten kutsun APIa suoraan verkkosovelluksen sijaan?
Lähetä POST-pyyntö osoitteeseen /api/presidio/image Bearer-tokenilla Authorization-otsikossa ja multipart/form-data-runko, joka sisältää file- ja mode-kentät ("analyze" tai "redact"). Katso yllä oleva API-viiteosio täydellisen kenttäluettelon ja vastausmuodon näkemiseksi.
Kokeile kuvien PII-peittämistä
Lataa skannaus, valokuva tai kuvakaappaus ja katso, kuinka tunnistettu PII peitetään muutamassa sekunnissa.
Avaa verkkosovellusLimitations / 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.