Penghitaman Imej — Panduan Penggunaan

Kesan dan tutup data peribadi di dalam imbasan, foto, dan tangkapan skrin. Panduan ini menerangkan aliran kerja muat naik, analisis, penghitaman, dan muat turun, had saiz dan format, sokongan bahasa OCR, serta panggilan API yang mendasarinya.

Buka aplikasi web Feature overview

Aliran kerja: muat naik, analisis, penghitaman, muat turun

Setiap imej melalui empat langkah yang sama, sama ada anda menggunakan aplikasi web, memanggil API secara langsung, atau menggunakan alat anonym_legal_redact_image melalui pelayan MCP.

1. Muat Naik

Pilih fail PNG atau JPG. Aplikasi menyemak jenis dan saiz fail berbanding had muat naik pelan anda sebelum menghantar apa-apa ke pelayan.

2. Analisis

OCR (Tesseract) membaca teks dalam imej dan merekodkan kedudukan setiap teks. Teks yang diekstrak itu kemudian dijalankan melalui pengesan PII yang sama seperti digunakan untuk dokumen, mengembalikan entiti yang ditemui dan kedudukannya — tiada apa yang diredak lagi.

3. Hitamkan

Jalankan semula permintaan dengan mod ditetapkan kepada "redact" untuk menutup setiap kawasan yang dikesan dengan kotak hitam pekat yang dilukis terus di atas piksel imej. Ini adalah penghitaman visual sehala, bukan penyulitan boleh balik.

4. Muat Turun

Imej yang diredak dikembalikan sebagai fail (PNG atau jenis kandungan asal) yang anda simpan secara tempatan — tiada apa yang disimpan di pelayan selepas respons dihantar.

Had saiz dan piksel

Hanya PNG dan JPG (JPEG) disokong. Format raster lain seperti TIFF, BMP, WebP, dan GIF tidak disokong pada masa ini.
Imej dihadkan pada 20 MB di sisi pelayan. Had pelan anda sendiri mungkin lebih rendah — pelan Basic mengehadkan muat naik pada 5 MB (Pro 10 MB, Business 20 MB); pelan percuma langsung tidak termasuk penghitaman imej.
Jumlah resolusi (lebar × tinggi) dihadkan pada 150 megapiksel. Muat naik melebihi had itu ditolak sebelum pemprosesan.

Sokongan bahasa OCR

OCR berjalan pada Tesseract. Medan bahasa API menerima kod ISO 639-1 (lalai kepada "en" untuk Bahasa Inggeris) yang dipetakan kepada pek bahasa Tesseract — kira-kira tiga dozen bahasa dipetakan, termasuk Jerman, Perancis, Sepanyol, Itali, Portugis, Belanda, Poland, Rusia, Ukraine, Arab, Ibrani, Hindi, Jepun, Korea, Cina, Thai, Vietnam, dan Turki. Ketersediaan sebenar bergantung pada pek Tesseract yang dipasang pada hos OCR; bahasa yang tidak tersedia akan kembali kepada Bahasa Inggeris.

Rujukan API

Penghitaman imej tersedia terus melalui API untuk integrasi yang tidak melalui aplikasi web, dan melalui pelayan MCP sebagai alat anonym_legal_redact_image (mod "analyze" atau "redact") untuk klien MCP seperti Claude.

POST /api/presidio/image

Authentication: Sahkan diri dengan token Bearer dalam pengepala Authorization (token API atau sesi yang disahkan, sama seperti titik akhir analisis teks). Permintaan tanpa token yang sah mengembalikan 401.

Request body: Hantar badan multipart/form-data. Medan diperlukan: file (imej PNG atau JPG) dan mode ("analyze" atau "redact"). Medan pilihan: language (kod bahasa OCR ISO 639-1, lalai "en"), entities (tatasusunan JSON jenis entiti untuk menyekat pengesanan), score_threshold, dan fill_color (mod redact sahaja, lalai "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: Dalam mod analyze, respons adalah JSON: entiti yang dikesan (jenis, kedudukan teks, dan skor keyakinan) ditambah medan tokens_charged. Dalam mod redact, respons adalah imej yang diredak itu sendiri (binari, Content-Type image/png atau jenis asal) dengan kos token dikembalikan dalam pengepala X-Tokens-Charged.

Soalan Lazim

Format imej apa yang disokong?

Hanya PNG dan JPG (JPEG). Format raster lain seperti TIFF, BMP, WebP, dan GIF tidak disokong pada masa ini.

Apakah had saiz dan resolusi?

20 MB dan jumlah resolusi 150 megapiksel, dihadkan lagi oleh had muat naik pelan anda sendiri (5 MB pada Basic, 10 MB pada Pro, 20 MB pada Business).

Adakah penghitaman imej memerlukan pelan berbayar?

Ya. Penghitaman imej memerlukan pelan Basic atau lebih tinggi. Pelan percuma hanya menyokong penganoniman teks.

Adakah penghitaman ini boleh dibalikkan?

Tidak. Penghitaman menutup kawasan yang dikesan dengan kotak hitam legap terus di atas piksel imej — penghitaman visual sehala, bukan penyulitan boleh balik seperti yang ditawarkan oleh penganonim teks.

Bagaimana saya memanggil API secara langsung selain menggunakan aplikasi web?

Hantar permintaan POST ke /api/presidio/image dengan token Bearer dalam pengepala Authorization dan badan multipart/form-data yang mengandungi file dan mode ("analyze" atau "redact"). Lihat bahagian rujukan API di atas untuk senarai medan penuh dan bentuk respons.

Cuba penghitaman imej

Muat naik imbasan, foto, atau tangkapan skrin dan lihat PII yang dikesan ditutup dalam beberapa saat.

Buka aplikasi web

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