Vaizdų užtamsinimas — naudojimo vadovas

Aptikite ir uždenkite asmens duomenis skenuose, nuotraukose ir ekrano nuotraukose. Šis vadovas žingsnis po žingsnio pristato įkėlimo, analizės, užtamsinimo ir atsisiuntimo darbo eigą, dydžio ir formato ribas, OCR kalbų palaikymą ir pagrindinį API kvietimą.

Atidaryti žiniatinklio programą Feature overview

Darbo eiga: įkėlimas, analizė, užtamsinimas, atsisiuntimas

Kiekvienas vaizdas pereina tuos pačius keturis žingsnius, nesvarbu, ar naudojate žiniatinklio programą, ar kviečiate API tiesiogiai, ar iškviečiate anonym_legal_redact_image įrankį per MCP serverį.

1. Įkėlimas

Pasirinkite PNG ar JPG failą. Programa patikrina failo tipą ir dydį pagal jūsų plano įkėlimo ribą, prieš siųsdama bet ką į serverį.

2. Analizė

OCR (Tesseract) perskaito tekstą vaizde ir užfiksuoja, kur kiekvienas teksto fragmentas yra. Tada šis ištrauktas tekstas apdorojamas tuo pačiu PII detektoriumi, kuris naudojamas dokumentams, grąžinant rastus objektus ir jų pozicijas — dar niekas nėra užtamsinta.

3. Užtamsinimas

Pakartokite užklausą su režimu, nustatytu į „redact“, kad kiekviena aptikta sritis būtų uždengta vientisu juodu langeliu, nupieštu tiesiai ant vaizdo pikselių. Tai vienpusis vizualus užtamsinimas, o ne atvirkštinis šifravimas.

4. Atsisiuntimas

Užtamsintas vaizdas grąžinamas kaip failas (PNG arba originalus turinio tipas), kurį išsaugote lokaliai — po atsakymo išsiuntimo serveryje niekas nesaugoma.

Dydžio ir pikselių ribos

Palaikomi tik PNG ir JPG (JPEG). Kiti rastro formatai, tokie kaip TIFF, BMP, WebP ir GIF, šiuo metu nepalaikomi.
Vaizdai serverio pusėje ribojami iki 20 MB. Jūsų plano riba gali būti žemesnė — Basic planas riboja įkėlimus iki 5 MB (Pro 10 MB, Business 20 MB); nemokamas planas visiškai neapima vaizdų užtamsinimo.
Bendra raiška (plotis × aukštis) ribojama iki 150 megapikselių. Įkėlimai, viršijantys šią ribą, atmetami prieš apdorojimą.

OCR kalbų palaikymas

OCR veikia su Tesseract. API kalbos laukas priima ISO 639-1 kodą (numatytasis „en“ anglų kalbai), susietą su Tesseract kalbos paketu — susieta apie tris dešimtis kalbų, įskaitant vokiečių, prancūzų, ispanų, italų, portugalų, olandų, lenkų, rusų, ukrainiečių, arabų, hebrajų, hindi, japonų, korėjiečių, kinų, tajų, vietnamiečių ir turkų kalbas. Faktinis prieinamumas priklauso nuo to, kurie Tesseract paketai įdiegti OCR serveryje; nepasiekiama kalba pereina prie anglų kalbos.

API nuoroda

Vaizdų užtamsinimas pasiekiamas tiesiogiai per API integracijoms, kurios neina per žiniatinklio programą, ir per MCP serverį kaip anonym_legal_redact_image įrankis (režimas „analyze" arba „redact") MCP klientams, tokiems kaip Claude.

POST /api/presidio/image

Authentication: Autentifikuokitės su Bearer žetonu Authorization antraštėje (API žetonas arba autentifikuota sesija, taip pat, kaip ir teksto analizės galiniuose taškuose). Užklausos be galiojančio žetono grąžina 401.

Request body: Siųskite multipart/form-data turinį. Privalomi laukai: file (PNG ar JPG vaizdas) ir mode („analyze“ arba „redact“). Pasirinktiniai laukai: language (ISO 639-1 OCR kalbos kodas, numatytasis „en“), entities (JSON masyvas objektų tipų, prie kurių apriboti aptikimą), score_threshold ir fill_color (tik redact režime, numatytasis „black“), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: Analizės režime atsakymas yra JSON: aptikti objektai (tipas, teksto pozicija ir patikimumo balas) bei tokens_charged laukas. Užtamsinimo režime atsakymas yra pats užtamsintas vaizdas (dvejetainis, Content-Type image/png arba originalus tipas), o žetonų kaina grąžinama X-Tokens-Charged antraštėje.

DUK

Kokie vaizdų formatai palaikomi?

Tik PNG ir JPG (JPEG). Kiti rastro formatai, tokie kaip TIFF, BMP, WebP ir GIF, šiuo metu nepalaikomi.

Kokios yra dydžio ir raiškos ribos?

20 MB ir 150 megapikselių bendra raiška, papildomai apribota jūsų plano įkėlimo riba (5 MB Basic, 10 MB Pro, 20 MB Business).

Ar vaizdų užtamsinimui reikalingas mokamas planas?

Taip. Vaizdų užtamsinimui reikalingas Basic planas ar aukštesnis. Nemokamas planas palaiko tik teksto anonimizavimą.

Ar užtamsinimas yra atvirkštinis?

Ne. Užtamsinimas uždengia aptiktą sritį nepermatomu juodu langeliu tiesiai ant vaizdo pikselių — tai vienpusis vizualus užtamsinimas, o ne atvirkštinis šifravimas, kokį siūlo teksto anonimizatorius.

Kaip kviesti API tiesiogiai, nenaudojant žiniatinklio programos?

Siųskite POST užklausą į /api/presidio/image su Bearer žetonu Authorization antraštėje ir multipart/form-data turiniu, kuriame yra file ir mode („analyze“ arba „redact“). Pilną laukų sąrašą ir atsakymo formą rasite aukščiau esančiame API nuorodos skyriuje.

Išbandykite vaizdų užtamsinimą

Įkelkite skeną, nuotrauką ar ekrano nuotrauką ir per kelias sekundes pamatykite aptiktą PII uždengtą.

Atidaryti žiniatinklio programą

Limitations / 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.

How we measure — our methodology