Por George Curta ·
Ocultación de Imágenes — Guía de Uso
Detecte y cubra datos personales dentro de escaneos, fotos y capturas de pantalla. Esta guía recorre el flujo de subir, analizar, ocultar y descargar, los límites de tamaño y formato, el soporte de idiomas de OCR y la llamada a la API subyacente.
Flujo de trabajo: subir, analizar, ocultar, descargar
Cada imagen pasa por los mismos cuatro pasos, ya sea que use la aplicación web, llame a la API directamente o invoque la herramienta anonym_legal_redact_image a través del servidor MCP.
1. Subir
Elija un archivo PNG o JPG. La aplicación verifica el tipo y el tamaño del archivo según el límite de subida de su plan antes de enviar nada al servidor.
2. Analizar
El OCR (Tesseract) lee el texto de la imagen y registra la posición de cada fragmento de texto. Ese texto extraído se procesa luego con el mismo detector de PII utilizado para documentos, devolviendo las entidades encontradas y sus posiciones — aún no se oculta nada.
3. Ocultar
Vuelva a ejecutar la solicitud con mode establecido en "redact" para cubrir cada región detectada con un recuadro negro sólido dibujado directamente sobre los píxeles de la imagen. Se trata de una ocultación visual e irreversible, no de un cifrado reversible.
4. Descargar
La imagen con los datos ocultados se devuelve como un archivo (PNG o el tipo de contenido original) que usted guarda localmente — nada se conserva en el servidor después de enviar la respuesta.
Límites de tamaño y píxeles
- Solo se admiten PNG y JPG (JPEG). Otros formatos ráster como TIFF, BMP, WebP y GIF no son compatibles actualmente.
- Las imágenes están limitadas a 20 MB en el servidor. El límite de su plan puede ser menor — el plan Basic limita las subidas a 5 MB (Pro 10 MB, Business 20 MB); el plan gratuito no incluye la ocultación de imágenes en absoluto.
- La resolución total (ancho × alto) está limitada a 150 megapíxeles. Las subidas por encima de ese límite se rechazan antes del procesamiento.
Soporte de idiomas de OCR
El OCR se ejecuta con Tesseract. El campo language de la API acepta un código ISO 639-1 (por defecto "en" para inglés) que se asigna a un paquete de idioma de Tesseract — hay unos tres docenas de idiomas soportados, incluidos alemán, francés, español, italiano, portugués, neerlandés, polaco, ruso, ucraniano, árabe, hebreo, hindi, japonés, coreano, chino, tailandés, vietnamita y turco. La disponibilidad real depende de qué paquetes de Tesseract estén instalados en el servidor de OCR; un idioma no disponible recurre al inglés.
Referencia de la API
La ocultación de imágenes está disponible directamente a través de la API para integraciones que no pasan por la aplicación web, y a través del servidor MCP como la herramienta anonym_legal_redact_image (modo "analyze" o "redact") para clientes MCP como Claude.
POST /api/presidio/imageAuthentication: Autentíquese con un token Bearer en el encabezado Authorization (un token de API o una sesión autenticada, igual que los puntos finales de análisis de texto). Las solicitudes sin un token válido devuelven 401.
Request body: Envíe un cuerpo multipart/form-data. Campos obligatorios: file (la imagen PNG o JPG) y mode ("analyze" o "redact"). Campos opcionales: language (código de idioma ISO 639-1 para OCR, por defecto "en"), entities (un array JSON de tipos de entidad a los que restringir la detección), score_threshold y fill_color (solo en modo redact, por defecto "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: En modo analyze, la respuesta es JSON: las entidades detectadas (tipo, posición del texto y puntuación de confianza) más un campo tokens_charged. En modo redact, la respuesta es la propia imagen con los datos ocultados (binaria, Content-Type image/png o el tipo original) con el coste en tokens devuelto en el encabezado X-Tokens-Charged.
Preguntas frecuentes
¿Qué formatos de imagen son compatibles?
Solo PNG y JPG (JPEG). Otros formatos ráster como TIFF, BMP, WebP y GIF no son compatibles actualmente.
¿Cuáles son los límites de tamaño y resolución?
20 MB y 150 megapíxeles de resolución total, limitados aún más por el límite de subida de su propio plan (5 MB en Basic, 10 MB en Pro, 20 MB en Business).
¿La ocultación de imágenes requiere un plan de pago?
Sí. La ocultación de imágenes requiere un plan Basic o superior. El plan gratuito solo admite la anonimización de texto.
¿Es reversible la ocultación?
No. La ocultación cubre la región detectada con un recuadro negro opaco directamente sobre los píxeles de la imagen — una ocultación visual e irreversible, no un cifrado reversible como el que ofrece el anonimizador de texto.
¿Cómo llamo a la API directamente en lugar de usar la aplicación web?
Envíe una solicitud POST a /api/presidio/image con un token Bearer en el encabezado Authorization y un cuerpo multipart/form-data que contenga file y mode ("analyze" o "redact"). Consulte la sección de referencia de la API anterior para conocer la lista completa de campos y el formato de la respuesta.
Prueba la ocultación de imágenes
Sube un escaneo, una foto o una captura de pantalla y observa cómo el PII detectado queda cubierto en unos segundos.
Abrir la aplicación 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.