Oleh George Curta · Terakhir diperbarui 2026-10-22

Penghitaman Gambar — Panduan Penggunaan

Deteksi dan tutupi data pribadi di dalam hasil pindaian, foto, dan tangkapan layar. Panduan ini menjelaskan alur kerja unggah, analisis, penghitaman, dan unduh, batas ukuran dan format, dukungan bahasa OCR, dan panggilan API yang mendasarinya.

Buka aplikasi web Feature overview

Alur kerja: unggah, analisis, penghitaman, unduh

Setiap gambar melalui empat langkah yang sama, baik Anda menggunakan aplikasi web, memanggil API secara langsung, atau memanggil alat anonym_legal_redact_image melalui server MCP.

1. Unggah

Pilih file PNG atau JPG. Aplikasi memeriksa jenis dan ukuran file terhadap batas unggahan rencana Anda sebelum mengirimkan apa pun ke server.

2. Analisis

OCR (Tesseract) membaca teks dalam gambar dan mencatat posisi setiap bagian teks. Teks yang diekstrak tersebut kemudian diproses melalui detektor PII yang sama dengan yang digunakan untuk dokumen, mengembalikan entitas yang ditemukan beserta posisinya — belum ada yang diredaksi pada tahap ini.

3. Hitamkan

Jalankan kembali permintaan dengan mode diatur ke "redact" untuk menutup setiap wilayah yang terdeteksi dengan kotak hitam solid yang digambar langsung pada piksel gambar. Ini adalah penghitaman visual satu arah, bukan enkripsi yang dapat dibalik.

4. Unduh

Gambar yang telah diredaksi dikembalikan sebagai file (PNG atau jenis konten aslinya) yang Anda simpan secara lokal — tidak ada yang disimpan di server setelah respons dikirim.

Batas ukuran dan piksel

Hanya PNG dan JPG (JPEG) yang didukung. Format raster lain seperti TIFF, BMP, WebP, dan GIF saat ini belum didukung.
Gambar dibatasi hingga 20 MB di sisi server. Batas rencana Anda sendiri mungkin lebih rendah — rencana Basic membatasi unggahan hingga 5 MB (Pro 10 MB, Business 20 MB); rencana gratis sama sekali tidak mencakup penghitaman gambar.
Total resolusi (lebar × tinggi) dibatasi hingga 150 megapiksel. Unggahan di atas batas tersebut ditolak sebelum diproses.

Dukungan bahasa OCR

OCR berjalan di atas Tesseract. Bidang language pada API menerima kode ISO 639-1 (default "en" untuk bahasa Inggris) yang dipetakan ke paket bahasa Tesseract — sekitar tiga lusin bahasa telah dipetakan, termasuk Jerman, Prancis, Spanyol, Italia, Portugis, Belanda, Polandia, Rusia, Ukraina, Arab, Ibrani, Hindi, Jepang, Korea, Cina, Thai, Vietnam, dan Turki. Ketersediaan sebenarnya bergantung pada paket Tesseract mana yang terpasang di host OCR; bahasa yang tidak tersedia akan kembali ke bahasa Inggris.

Referensi API

Penghitaman gambar tersedia langsung melalui API untuk integrasi yang tidak melalui aplikasi web, dan melalui server MCP sebagai alat anonym_legal_redact_image (mode "analyze" atau "redact") untuk klien MCP seperti Claude.

POST /api/presidio/image

Authentication: Autentikasi dengan token Bearer di header Authorization (token API atau sesi yang terautentikasi, sama seperti endpoint analisis teks). Permintaan tanpa token yang valid akan mengembalikan 401.

Request body: Kirim body multipart/form-data. Bidang wajib: file (gambar PNG atau JPG) dan mode ("analyze" atau "redact"). Bidang opsional: language (kode bahasa OCR ISO 639-1, default "en"), entities (array JSON jenis entitas untuk membatasi deteksi), score_threshold, dan fill_color (hanya mode redact, default "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").

Response: Dalam mode analyze, respons berupa JSON: entitas yang terdeteksi (jenis, posisi teks, dan skor kepercayaan) ditambah bidang tokens_charged. Dalam mode redact, respons adalah gambar yang telah diredaksi itu sendiri (biner, Content-Type image/png atau jenis aslinya) dengan biaya token dikembalikan pada header X-Tokens-Charged.

FAQ

Format gambar apa saja yang didukung?

Hanya PNG dan JPG (JPEG). Format raster lain seperti TIFF, BMP, WebP, dan GIF saat ini belum didukung.

Apa saja batas ukuran dan resolusi?

20 MB dan total resolusi 150 megapiksel, dibatasi lebih lanjut oleh batas unggahan rencana Anda sendiri (5 MB pada Basic, 10 MB pada Pro, 20 MB pada Business).

Apakah penghitaman gambar memerlukan rencana berbayar?

Ya. Penghitaman gambar memerlukan rencana Basic atau lebih tinggi. Rencana gratis hanya mendukung anonimisasi teks.

Apakah penghitaman ini dapat dibalik?

Tidak. Penghitaman menutup wilayah yang terdeteksi dengan kotak hitam buram langsung pada piksel gambar — penghitaman visual satu arah, bukan enkripsi yang dapat dibalik seperti yang ditawarkan oleh anonymizer teks.

Bagaimana cara memanggil API secara langsung alih-alih menggunakan aplikasi web?

Kirim permintaan POST ke /api/presidio/image dengan token Bearer di header Authorization dan body multipart/form-data berisi file dan mode ("analyze" atau "redact"). Lihat bagian referensi API di atas untuk daftar bidang lengkap dan bentuk respons.

Coba penghitaman gambar

Unggah hasil pindaian, foto, atau tangkapan layar dan lihat PII yang terdeteksi tertutup dalam hitungan detik.

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