Di George Curta ·
Oscuramento delle Immagini — Guida all'Uso
Rileva e copri i dati personali all'interno di scansioni, foto e screenshot. Questa guida illustra il flusso di lavoro di caricamento, analisi, oscuramento e download, i limiti di dimensione e formato, il supporto linguistico OCR e la chiamata API sottostante.
Flusso di lavoro: carica, analizza, oscura, scarica
Ogni immagine attraversa gli stessi quattro passaggi, che tu usi la web app, chiami direttamente l'API o richiami lo strumento anonym_legal_redact_image tramite il server MCP.
1. Carica
Scegli un file PNG o JPG. L'app controlla il tipo e la dimensione del file rispetto al limite di caricamento del tuo piano prima di inviare qualsiasi cosa al server.
2. Analizza
L'OCR (Tesseract) legge il testo nell'immagine e registra dove si trova ogni porzione di testo. Quel testo estratto viene poi elaborato dallo stesso rilevatore di PII usato per i documenti, restituendo le entità trovate e le loro posizioni — non viene ancora redatto nulla.
3. Oscura
Riesegui la richiesta con mode impostato su "redact" per coprire ogni regione rilevata con un riquadro nero pieno disegnato direttamente sui pixel dell'immagine. Questa è un oscuramento visivo a senso unico, non una crittografia reversibile.
4. Scarica
L'immagine redatta viene restituita come file (PNG o il tipo di contenuto originale) che salvi localmente — nulla viene conservato sul server dopo l'invio della risposta.
Limiti di dimensione e pixel
- Sono supportati solo PNG e JPG (JPEG). Altri formati raster come TIFF, BMP, WebP e GIF non sono attualmente supportati.
- Le immagini sono limitate a 20 MB lato server. Il limite del tuo piano potrebbe essere inferiore — il piano Basic limita i caricamenti a 5 MB (Pro 10 MB, Business 20 MB); il piano gratuito non include affatto l'oscuramento delle immagini.
- La risoluzione totale (larghezza × altezza) è limitata a 150 megapixel. I caricamenti oltre questo limite vengono rifiutati prima dell'elaborazione.
Supporto linguistico OCR
L'OCR funziona su Tesseract. Il campo language dell'API accetta un codice ISO 639-1 (predefinito "en" per l'inglese) mappato a un pacchetto linguistico Tesseract — sono mappate circa tre dozzine di lingue, tra cui tedesco, francese, spagnolo, italiano, portoghese, olandese, polacco, russo, ucraino, arabo, ebraico, hindi, giapponese, coreano, cinese, thailandese, vietnamita e turco. La disponibilità effettiva dipende da quali pacchetti Tesseract sono installati sull'host OCR; una lingua non disponibile ripiega sull'inglese.
Riferimento API
L'oscuramento delle immagini è disponibile direttamente tramite l'API per le integrazioni che non passano dalla web app, e tramite il server MCP come strumento anonym_legal_redact_image (modalità "analyze" o "redact") per i client MCP come Claude.
POST /api/presidio/imageAuthentication: Autenticati con un token Bearer nell'header Authorization (un token API o una sessione autenticata, allo stesso modo degli endpoint di analisi del testo). Le richieste senza un token valido restituiscono 401.
Request body: Invia un corpo multipart/form-data. Campi obbligatori: file (l'immagine PNG o JPG) e mode ("analyze" o "redact"). Campi opzionali: language (codice lingua OCR ISO 639-1, predefinito "en"), entities (un array JSON dei tipi di entità a cui limitare il rilevamento), score_threshold e fill_color (solo modalità redact, predefinito "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: In modalità analyze la risposta è JSON: le entità rilevate (tipo, posizione del testo e punteggio di affidabilità) più un campo tokens_charged. In modalità redact la risposta è l'immagine redatta stessa (binaria, Content-Type image/png o il tipo originale) con il costo in token restituito nell'header X-Tokens-Charged.
FAQ
Quali formati di immagine sono supportati?
Solo PNG e JPG (JPEG). Altri formati raster come TIFF, BMP, WebP e GIF non sono attualmente supportati.
Quali sono i limiti di dimensione e risoluzione?
20 MB e 150 megapixel di risoluzione totale, ulteriormente limitati dal limite di caricamento del tuo piano (5 MB su Basic, 10 MB su Pro, 20 MB su Business).
L'oscuramento delle immagini richiede un piano a pagamento?
Sì. L'oscuramento delle immagini richiede un piano Basic o superiore. Il piano gratuito supporta solo l'anonimizzazione del testo.
L'oscuramento è reversibile?
No. L'oscuramento copre la regione rilevata con un riquadro nero opaco direttamente sui pixel dell'immagine — un oscuramento visivo a senso unico, non una crittografia reversibile come quella offerta dall'anonimizzatore di testo.
Come chiamo direttamente l'API invece di usare l'app web?
Invia una richiesta POST a /api/presidio/image con un token Bearer nell'header Authorization e un corpo multipart/form-data contenente file e mode ("analyze" o "redact"). Consulta la sezione di riferimento API sopra per l'elenco completo dei campi e la forma della risposta.
Prova l'oscuramento delle immagini
Carica una scansione, una foto o uno screenshot e guarda i PII rilevati coperti in pochi secondi.
Apri l'app 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.