Irudietako PII Ezkutatzea — Erabilera Gida

Detektatu eta estali datu pertsonalak eskaneatzeen, argazkien eta pantaila-argazkien barnean. Gida honek igoera, azterketa, ezkutatze eta deskarga lan-fluxua, tamaina eta formatu mugak, OCR hizkuntza euskarria, eta oinarrizko API deia azaltzen ditu.

Ireki web aplikazioa Feature overview

Lan-fluxua: igo, aztertu, ezkutatu, deskargatu

Irudi bakoitzak lau urrats berberak zeharkatzen ditu, web aplikazioa erabili, APIari zuzenean deitu, edo anonym_legal_redact_image tresna MCP zerbitzariaren bidez exekutatu, edonola ere.

1. Igotzea

Aukeratu PNG edo JPG fitxategi bat. Aplikazioak fitxategiaren mota eta tamaina zure planaren igoera-mugarekin egiaztatzen ditu, zerbitzarira ezer bidali aurretik.

2. Aztertzea

OCRk (Tesseract) irudiko testua irakurtzen du eta testu-zati bakoitza non dagoen erregistratzen du. Ondoren erauzitako testu horrek dokumentuetarako erabiltzen den PII detektatzaile berbera zeharkatzen du, aurkitutako entitateak eta haien kokapenak itzuliz — oraindik ezer ez da ezkutatu.

3. Ezkutatzea

Berregin eskaera, moduarekin (mode) "redact" ezarrita, detektatutako eremu bakoitza irudiaren pixeletan zuzenean marraztutako kutxa beltz solido batekin estaltzeko. Noranzko bakarreko ezkutatze bisuala da, ez enkriptazio itzulgarria.

4. Deskargatzea

Ezkutatutako irudia fitxategi gisa itzultzen da (PNG edo jatorrizko eduki-mota), lokalki gordetzen duzuna — erantzuna bidali ondoren ezer ez da zerbitzarian mantentzen.

Tamaina eta pixel mugak

PNG eta JPG (JPEG) bakarrik onartzen dira. Beste raster formatu batzuk, hala nola TIFF, BMP, WebP eta GIF, momentuz ez dira onartzen.
Irudiak 20 MB-tan mugatuta daude zerbitzari-aldean. Zure planaren muga bera baxuagoa izan daiteke — Basic planak igoerak 5 MB-tan mugatzen ditu (Pro 10 MB, Business 20 MB); plan doaneak ez du irudietako PII ezkutatzerik batere biltzen.
Bereizmen osoa (zabalera × altuera) 150 megapixeletan mugatuta dago. Muga hori gainditzen duten igoerak baztertu egiten dira prozesatu aurretik.

OCR hizkuntza euskarria

OCRak Tesseract-en gainean funtzionatzen du. APIaren language eremuak ISO 639-1 kode bat onartzen du (lehenetsia "en", ingelesa), Tesseract hizkuntza-pakete batekin mapatua — hiru dozena hizkuntza inguru mapatuta daude, besteak beste alemana, frantsesa, gaztelania, italiera, portugesa, nederlandera, poloniera, errusiera, ukrainera, arabiera, hebreera, hindia, japoniera, koreera, txinera, thailandiera, vietnamera eta turkiera. Benetako eskuragarritasuna OCR zerbitzarian instalatuta dauden Tesseract paketeen araberakoa da; eskuragarri ez dagoen hizkuntza batek ingelesera itzultzen du.

API Erreferentzia

Irudietako PII ezkutatzea zuzenean eskuragarri dago APIaren bidez, web aplikaziotik pasatzen ez diren integrazioetarako, eta MCP zerbitzariaren bidez anonym_legal_redact_image tresna gisa ("analyze" edo "redact" moduan), Claude bezalako MCP bezeroentzat.

POST /api/presidio/image

Authentication: Autentifikatu zaitez Bearer token batekin Authorization goiburuan (API token bat edo autentifikatutako saio bat, testu-analisirako endpointetan bezala). Token baliogabearekin egindako eskaerek 401 itzultzen dute.

Request body: Bidali multipart/form-data gorputz bat. Beharrezko eremuak: file (PNG edo JPG irudia) eta mode ("analyze" edo "redact"). Aukerako eremuak: language (ISO 639-1 OCR hizkuntza-kodea, lehenetsia "en"), entities (detekzioa mugatuko zaion entitate-motan JSON array bat), score_threshold, eta fill_color (redact moduan bakarrik, lehenetsia "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: Analyze moduan erantzuna JSON da: detektatutako entitateak (mota, testu-kokapena eta konfiantza-puntuazioa) gehi tokens_charged eremu bat. Redact moduan erantzuna ezkutatutako irudia bera da (bitarra, Content-Type image/png edo jatorrizko mota), token-kostua X-Tokens-Charged goiburuan itzulita.

Maiz Egiten Diren Galderak

Zein irudi-formatu onartzen dira?

PNG eta JPG (JPEG) bakarrik. Beste raster formatu batzuk, hala nola TIFF, BMP, WebP eta GIF, momentuz ez dira onartzen.

Zein dira tamaina eta bereizmen mugak?

20 MB eta 150 megapixel bereizmen osoan, zure planaren igoera-mugak are gehiago mugatuta (5 MB Basic-en, 10 MB Pro-n, 20 MB Business-en).

Irudietako PII ezkutatzeak plan ordaindua behar al du?

Bai. Irudietako PII ezkutatzeak Basic plana edo altuagoa behar du. Plan doaneak testua anonimizatzea bakarrik onartzen du.

Ezkutatzea itzulgarria al da?

Ez. Ezkutatzeak detektatutako eremua kutxa beltz opaku batekin estaltzen du irudiaren pixeletan zuzenean — noranzko bakarreko ezkutatze bisuala, ez testu-anonimizatzaileak eskaintzen duen bezalako enkriptazio itzulgarria.

Nola deitu APIari zuzenean, web aplikazioa erabili gabe?

Bidali POST eskaera bat /api/presidio/image helbidera, Bearer token batekin Authorization goiburuan eta multipart/form-data gorputz batekin, file eta mode ("analyze" edo "redact") edukiz. Ikusi goiko API erreferentzia atala eremu-zerrenda osoa eta erantzunaren forma ikusteko.

Probatu irudietako PII ezkutatzea

Igo eskaneatze bat, argazki bat edo pantaila-argazki bat, eta ikusi detektatutako PIIa segundo gutxitan estaltzen.

Ireki web aplikazioa

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