Per George Curta ·
Ocultació d'Imatges — Guia d'Ús
Detecta i cobreix dades personals dins d'escanejos, fotos i captures de pantalla. Aquesta guia repassa el flux de pujada, anàlisi, ocultació i descàrrega, els límits de mida i format, el suport de llengües de l'OCR i la crida a l'API subjacent.
Flux de treball: pujar, analitzar, ocultar, descarregar
Cada imatge passa pels mateixos quatre passos, tant si utilitzes l'aplicació web, crides directament l'API, com si invoques l'eina anonym_legal_redact_image mitjançant el servidor MCP.
1. Puja
Tria un fitxer PNG o JPG. L'aplicació comprova el tipus i la mida del fitxer respecte al límit de pujada del teu pla abans d'enviar res al servidor.
2. Analitza
L'OCR (Tesseract) llegeix el text de la imatge i registra on se situa cada fragment de text. Aquest text extret passa després pel mateix detector de PII utilitzat per als documents, i retorna les entitats trobades i les seves posicions — encara no s'oculta res.
3. Oculta
Torna a executar la sol·licitud amb mode establert a "redact" per cobrir cada regió detectada amb una caixa negra sòlida dibuixada directament sobre els píxels de la imatge. Es tracta d'una ocultació visual d'un sol sentit, no d'un xifrat reversible.
4. Descarrega
La imatge amb les dades ocultades es retorna com un fitxer (PNG o el tipus de contingut original) que desis localment — no es conserva res al servidor després d'enviar la resposta.
Límits de mida i píxels
- Només són compatibles PNG i JPG (JPEG). Altres formats rasteritzats com TIFF, BMP, WebP i GIF no són compatibles actualment.
- Les imatges tenen un límit de 20 MB al servidor. El límit del teu pla pot ser inferior — el pla Basic limita les pujades a 5 MB (Pro 10 MB, Business 20 MB); el pla gratuït no inclou l'ocultació d'imatges.
- La resolució total (amplada × alçada) té un límit de 150 megapíxels. Les pujades que superen aquest límit es rebutgen abans del processament.
Suport de llengües de l'OCR
L'OCR funciona amb Tesseract. El camp language de l'API accepta un codi ISO 639-1 (per defecte "en" per a l'anglès) associat a un paquet de llengua de Tesseract — hi ha unes tres dotzenes de llengües associades, incloent-hi l'alemany, el francès, l'espanyol, l'italià, el portuguès, el neerlandès, el polonès, el rus, l'ucraïnès, l'àrab, l'hebreu, l'hindi, el japonès, el coreà, el xinès, el tailandès, el vietnamita i el turc. La disponibilitat real depèn de quins paquets de Tesseract estiguin instal·lats al servidor de l'OCR; una llengua no disponible recorre a l'anglès.
Referència de l'API
L'ocultació d'imatges està disponible directament mitjançant l'API per a integracions que no passen per l'aplicació web, i mitjançant el servidor MCP com a eina anonym_legal_redact_image (mode "analyze" o "redact") per a clients MCP com Claude.
POST /api/presidio/imageAuthentication: Autentica't amb un token Bearer a la capçalera Authorization (un token API o una sessió autenticada, igual que als punts d'accés d'anàlisi de text). Les sol·licituds sense un token vàlid retornen 401.
Request body: Envia un cos multipart/form-data. Camps obligatoris: file (la imatge PNG o JPG) i mode ("analyze" o "redact"). Camps opcionals: language (codi de llengua OCR ISO 639-1, per defecte "en"), entities (una matriu JSON de tipus d'entitat als quals restringir la detecció), score_threshold, i fill_color (només en mode redact, per defecte "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: En mode analyze, la resposta és JSON: les entitats detectades (tipus, posició del text i puntuació de confiança) més un camp tokens_charged. En mode redact, la resposta és la mateixa imatge amb les dades ocultades (binària, Content-Type image/png o el tipus original) amb el cost en tokens retornat a la capçalera X-Tokens-Charged.
Preguntes Freqüents
Quins formats d'imatge són compatibles?
Només PNG i JPG (JPEG). Altres formats rasteritzats com TIFF, BMP, WebP i GIF no són compatibles actualment.
Quins són els límits de mida i resolució?
20 MB i 150 megapíxels de resolució total, limitats també pel límit de pujada del teu propi pla (5 MB al Basic, 10 MB al Pro, 20 MB al Business).
L'ocultació d'imatges requereix un pla de pagament?
Sí. L'ocultació d'imatges requereix el pla Basic o superior. El pla gratuït només admet l'anonimització de text.
És reversible l’ocultació?
No. L'ocultació cobreix la regió detectada amb una caixa negra opaca directament sobre els píxels de la imatge — una ocultació visual d'un sol sentit, no un xifrat reversible com el que ofereix l'anonimitzador de text.
Com puc cridar l'API directament en lloc d'utilitzar l'aplicació web?
Envia una sol·licitud POST a /api/presidio/image amb un token Bearer a la capçalera Authorization i un cos multipart/form-data que contingui file i mode ("analyze" o "redact"). Consulta la secció de referència de l'API més amunt per a la llista completa de camps i el format de la resposta.
Prova l'ocultació d'imatges
Puja un escaneig, una foto o una captura de pantalla i veu la PII detectada coberta en pocs segons.
Obre l'aplicació 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.