Von George Curta ·
Bildschwärzung — Nutzungsanleitung
Erkennen und verdecken Sie personenbezogene Daten in Scans, Fotos und Screenshots. Diese Anleitung führt durch den Workflow aus Hochladen, Analysieren, Schwärzen und Herunterladen, die Größen- und Formatlimits, die OCR-Sprachunterstützung und den zugrunde liegenden API-Aufruf.
Workflow: Hochladen, Analysieren, Schwärzen, Herunterladen
Jedes Bild durchläuft dieselben vier Schritte, egal ob Sie die Web-App verwenden, die API direkt aufrufen oder das Tool anonym_legal_redact_image über den MCP-Server nutzen.
1. Hochladen
Wählen Sie eine PNG- oder JPG-Datei. Die App prüft Dateityp und -größe gegen das Upload-Limit Ihres Plans, bevor irgendetwas an den Server gesendet wird.
2. Analysieren
OCR (Tesseract) liest den Text im Bild und erfasst, wo jeder Textabschnitt liegt. Dieser extrahierte Text durchläuft anschließend denselben PII-Detektor, der auch für Dokumente verwendet wird, und liefert die gefundenen Entitäten mit ihrer Position — noch wird nichts geschwärzt.
3. Schwärzen
Führen Sie die Anfrage erneut aus, diesmal mit dem Modus "redact", um jeden erkannten Bereich mit einem durchgehenden schwarzen Balken direkt auf den Bildpixeln abzudecken. Dies ist eine einseitige visuelle Schwärzung, keine umkehrbare Verschlüsselung.
4. Herunterladen
Das geschwärzte Bild wird als Datei (PNG oder der ursprüngliche Content-Type) zurückgegeben, die Sie lokal speichern — nach dem Senden der Antwort wird nichts auf dem Server aufbewahrt.
Größen- und Pixel-Limits
- Nur PNG und JPG (JPEG) werden unterstützt. Andere Rasterformate wie TIFF, BMP, WebP und GIF werden derzeit nicht unterstützt.
- Bilder sind serverseitig auf 20 MB begrenzt. Das Limit Ihres Plans kann niedriger sein — der Basic-Plan begrenzt Uploads auf 5 MB (Pro 10 MB, Business 20 MB); der kostenlose Plan enthält keine Bildschwärzung.
- Die Gesamtauflösung (Breite × Höhe) ist auf 150 Megapixel begrenzt. Uploads über diesem Limit werden vor der Verarbeitung abgelehnt.
OCR-Sprachunterstützung
OCR läuft auf Tesseract. Das API-Feld language akzeptiert einen ISO-639-1-Code (Standard "en" für Englisch), der auf ein Tesseract-Sprachpaket abgebildet wird — rund drei Dutzend Sprachen sind zugeordnet, darunter Deutsch, Französisch, Spanisch, Italienisch, Portugiesisch, Niederländisch, Polnisch, Russisch, Ukrainisch, Arabisch, Hebräisch, Hindi, Japanisch, Koreanisch, Chinesisch, Thai, Vietnamesisch und Türkisch. Die tatsächliche Verfügbarkeit hängt davon ab, welche Tesseract-Pakete auf dem OCR-Host installiert sind; eine nicht verfügbare Sprache fällt auf Englisch zurück.
API-Referenz
Die Bildschwärzung ist für Integrationen, die nicht über die Web-App laufen, direkt über die API verfügbar, sowie über den MCP-Server als Tool anonym_legal_redact_image (Modus „analyze" oder „redact") für MCP-Clients wie Claude.
POST /api/presidio/imageAuthentication: Authentifizieren Sie sich mit einem Bearer-Token im Authorization-Header (ein API-Token oder eine authentifizierte Sitzung, genau wie bei den Text-Analyse-Endpunkten). Anfragen ohne gültiges Token liefern 401.
Request body: Senden Sie einen multipart/form-data-Body. Pflichtfelder: file (das PNG- oder JPG-Bild) und mode ("analyze" oder "redact"). Optionale Felder: language (ISO-639-1-OCR-Sprachcode, Standard "en"), entities (ein JSON-Array der Entitätstypen, auf die die Erkennung beschränkt werden soll), score_threshold und fill_color (nur im redact-Modus, Standard "black"), operator (nur im redact-Modus: "redact" | "replace" | "mask", Standard "redact") sowie mask_char (nur im redact-Modus mit operator="mask", Standard "*").
Response: Im analyze-Modus ist die Antwort JSON: die erkannten Entitäten (Typ, Textposition und Konfidenzwert) sowie ein tokens_charged-Feld. Im redact-Modus ist die Antwort das geschwärzte Bild selbst (binär, Content-Type image/png oder der ursprüngliche Typ), wobei die Token-Kosten im Header X-Tokens-Charged zurückgegeben werden.
FAQ
Welche Bildformate werden unterstützt?
Nur PNG und JPG (JPEG). Andere Rasterformate wie TIFF, BMP, WebP und GIF werden derzeit nicht unterstützt.
Welche Größen- und Auflösungslimits gelten?
20 MB und 150 Megapixel Gesamtauflösung, zusätzlich begrenzt durch das Upload-Limit Ihres Plans (5 MB im Basic-Plan, 10 MB im Pro-Plan, 20 MB im Business-Plan).
Erfordert die Bildschwärzung einen kostenpflichtigen Plan?
Ja. Die Bildschwärzung erfordert einen Basic-Plan oder höher. Der kostenlose Plan unterstützt nur die Textanonymisierung.
Ist die Schwärzung umkehrbar?
Nein. Die Schwärzung deckt den erkannten Bereich mit einem undurchsichtigen schwarzen Balken direkt auf den Bildpixeln ab — eine einseitige visuelle Schwärzung, keine umkehrbare Verschlüsselung wie sie der Text-Anonymizer bietet.
Wie rufe ich die API direkt auf, statt die Web-App zu verwenden?
Senden Sie eine POST-Anfrage an /api/presidio/image mit einem Bearer-Token im Authorization-Header und einem multipart/form-data-Body mit file und mode ("analyze" oder "redact"). Die vollständige Feldliste und den Antwortaufbau finden Sie im Abschnitt API-Referenz oben.
Bildschwärzung ausprobieren
Laden Sie einen Scan, ein Foto oder einen Screenshot hoch und sehen Sie die erkannten PII in wenigen Sekunden abgedeckt.
Web-App öffnenLimitations / 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.