Autor: George Curta ·
Estomparea Imaginilor — Ghid de Utilizare
Detectați și acoperiți datele personale din scanări, fotografii și capturi de ecran. Acest ghid parcurge fluxul de încărcare, analiză, estompare și descărcare, limitele de dimensiune și format, suportul pentru limbi OCR și apelul API de bază.
Flux de lucru: încărcare, analiză, estompare, descărcare
Fiecare imagine parcurge aceiași patru pași, fie că folosiți aplicația web, apelați API-ul direct sau invocați instrumentul anonym_legal_redact_image prin serverul MCP.
1. Încărcare
Alegeți un fișier PNG sau JPG. Aplicația verifică tipul și dimensiunea fișierului în raport cu limita de încărcare a planului dvs. înainte de a trimite ceva către server.
2. Analiză
OCR (Tesseract) citește textul din imagine și înregistrează poziția fiecărei porțiuni de text. Textul extras trece apoi prin același detector de date PII folosit pentru documente, returnând entitățile găsite și pozițiile lor — nimic nu este încă estompat.
3. Estompare
Re-executați cererea cu modul setat pe "redact" pentru a acoperi fiecare regiune detectată cu o casetă neagră solidă desenată direct pe pixelii imaginii. Aceasta este o înnegrire vizuală ireversibilă, nu o criptare reversibilă.
4. Descărcare
Imaginea estompată este returnată ca fișier (PNG sau tipul original de conținut) pe care îl salvați local — nimic nu este păstrat pe server după trimiterea răspunsului.
Limite de dimensiune și pixeli
- Sunt acceptate doar PNG și JPG (JPEG). Alte formate raster, precum TIFF, BMP, WebP și GIF, nu sunt acceptate momentan.
- Imaginile sunt limitate la 20 MB pe server. Limita propriului dvs. plan poate fi mai mică — planul Basic limitează încărcările la 5 MB (Pro 10 MB, Business 20 MB); planul gratuit nu include deloc estomparea imaginilor.
- Rezoluția totală (lățime × înălțime) este limitată la 150 de megapixeli. Încărcările peste această limită sunt respinse înainte de procesare.
Suport pentru limbi OCR
OCR rulează pe Tesseract. Câmpul de limbă al API-ului acceptă un cod ISO 639-1 (implicit "en" pentru engleză) mapat la un pachet de limbă Tesseract — sunt mapate aproximativ trei duzini de limbi, inclusiv germană, franceză, spaniolă, italiană, portugheză, olandeză, poloneză, rusă, ucraineană, arabă, ebraică, hindi, japoneză, coreeană, chineză, thailandeză, vietnameză și turcă. Disponibilitatea reală depinde de pachetele Tesseract instalate pe serverul OCR; o limbă indisponibilă revine implicit la engleză.
Referință API
Înnegrirea imaginilor este disponibilă direct prin API pentru integrări care nu trec prin aplicația web, precum și prin serverul MCP ca instrumentul anonym_legal_redact_image (mod „analyze” sau „redact”) pentru clienți MCP precum Claude.
POST /api/presidio/imageAuthentication: Autentificați-vă cu un token Bearer în antetul Authorization (un token API sau o sesiune autentificată, la fel ca endpoint-urile de analiză a textului). Cererile fără un token valid returnează 401.
Request body: Trimiteți un corp multipart/form-data. Câmpuri obligatorii: file (imaginea PNG sau JPG) și mode ("analyze" sau "redact"). Câmpuri opționale: language (cod de limbă OCR ISO 639-1, implicit "en"), entities (un array JSON de tipuri de entități la care se restrânge detectarea), score_threshold și fill_color (doar în modul redact, implicit "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: În modul analyze, răspunsul este JSON: entitățile detectate (tip, poziția textului și scorul de încredere) plus un câmp tokens_charged. În modul redact, răspunsul este chiar imaginea cu datele înnegrite (binar, Content-Type image/png sau tipul original) cu costul în tokeni returnat în antetul X-Tokens-Charged.
Întrebări Frecvente
Ce formate de imagine sunt acceptate?
Doar PNG și JPG (JPEG). Alte formate raster, precum TIFF, BMP, WebP și GIF, nu sunt acceptate momentan.
Care sunt limitele de dimensiune și rezoluție?
20 MB și 150 de megapixeli rezoluție totală, limitate suplimentar de limita de încărcare a propriului dvs. plan (5 MB pe Basic, 10 MB pe Pro, 20 MB pe Business).
Estomparea imaginilor necesită un plan plătit?
Da. Estomparea imaginilor necesită un plan Basic sau superior. Planul gratuit acceptă doar anonimizarea textului.
Estomparea este reversibilă?
Nu. Estomparea acoperă regiunea detectată cu o casetă neagră opacă direct pe pixelii imaginii — o estompare vizuală ireversibilă, nu o criptare reversibilă precum cea oferită de anonimizatorul de text.
Cum apelez API-ul direct în loc să folosesc aplicația web?
Trimiteți o cerere POST către /api/presidio/image cu un token Bearer în antetul Authorization și un corp multipart/form-data conținând file și mode ("analyze" sau "redact"). Consultați secțiunea de referință API de mai sus pentru lista completă de câmpuri și forma răspunsului.
Încercați estomparea imaginilor
Încărcați o scanare, o fotografie sau o captură de ecran și vedeți datele PII detectate acoperite în câteva secunde.
Deschideți aplicația webLimitations / 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.