PNG Transparency Fixer

Memperbaiki PNG transparan palsu dengan satu klik. Menggunakan matting AI (model BiRefNet HR Matting) untuk menghasilkan transparansi alfa sejati, dengan pemrosesan pascanya defringe untuk membersihkan tepi.

API Endpoint

POST /api/v1/tools/image/transparency-fixer

Processing: Asinkron (mengembalikan 202, poll /api/v1/jobs/{jobId}/progress untuk status melalui SSE)

Model bundle: background-removal (4-5 GB)

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	File gambar (multipart)
defringe	number	No	30	Intensitas defringe (0-100). Menghapus piksel fringe semi-transparan di sekitar tepi
outputFormat	string	No	"png"	Format keluaran: png atau webp
removeWatermark	boolean	No	false	Menerapkan pemrosesan awal penghapusan watermark (median filter)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
  -F "[email protected]" \
  -F 'settings={"defringe":40,"outputFormat":"png"}'

Response

Initial Response (202 Accepted)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Progress (SSE at /api/v1/jobs/{jobId}/progress)

event: progress
data: {"phase":"processing","stage":"Processing transparency...","percent":50}

Final Result (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/fake-transparent_fixed.png",
    "originalSize": 180000,
    "processedSize": 150000,
    "filename": "fake-transparent.png"
  }
}

Notes

• Memerlukan model bundle background-removal untuk diinstal (4-5 GB).
• Menggunakan birefnet-hr-matting sebagai model utama untuk alpha matting berkualitas tinggi. Kembali ke birefnet-general jika model HR kehabisan memori.
• Opsi defringe menghapus piksel fringe semi-transparan yang terkadang ditinggalkan matting AI di sekitar rambut, bulu, dan tepi halus. Ini bekerja dengan mem-blur kanal alfa dan menolkan piksel berkeyakinan rendah.
• Opsi removeWatermark menerapkan langkah pemrosesan awal median filter. Ini adalah pengurangan watermark dasar, bukan alat penghapusan watermark khusus.
• Hanya menghasilkan PNG atau WebP lossless (keduanya mendukung transparansi alfa).
• Mendukung format masukan HEIC/HEIF, RAW, TGA, PSD, EXR, dan HDR melalui pendekodean otomatis.