PNG Saydamlık Düzeltici

Sahte saydam PNG'leri tek tıkla düzeltin. Gerçek alfa saydamlığı üretmek için AI matlama (BiRefNet HR Matting modeli) kullanır, kenarları temizlemek için defringe son işleme uygular.

API Uç Noktası

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

İşleme: Eşzamansız (202 döner, durum için SSE aracılığıyla /api/v1/jobs/{jobId}/progress üzerinden sorgulanır)

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

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
file	file	Evet	-	Görüntü dosyası (multipart)
defringe	number	Hayır	30	Defringe yoğunluğu (0-100). Kenarlar çevresindeki yarı saydam saçak piksellerini kaldırır
outputFormat	string	Hayır	"png"	Çıktı biçimi: png veya webp
removeWatermark	boolean	Hayır	false	Filigran kaldırma ön işlemesi uygula (medyan filtresi)

Örnek İstek

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

Yanıt

İlk Yanıt (202 Accepted)

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

İlerleme (/api/v1/jobs/{jobId}/progress üzerinde SSE)

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

Nihai Sonuç (SSE aracılığıyla)

{
  "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"
  }
}

Notlar

• background-removal model paketinin kurulmuş olmasını gerektirir (4-5 GB).
• Yüksek kaliteli alfa matlama için birincil model olarak birefnet-hr-matting kullanır. HR modeli bellek yetersizliğine düşerse birefnet-general modeline geri döner.
• defringe seçeneği, AI matlamanın bazen saç, kürk ve ince kenarlar çevresinde bıraktığı yarı saydam saçak piksellerini kaldırır. Alfa kanalını bulanıklaştırıp düşük güvenilirlikli pikselleri sıfırlayarak çalışır.
• removeWatermark seçeneği, bir medyan filtresi ön işleme adımı uygular. Bu, özel bir filigran kaldırma aracı değil, temel bir filigran azaltmadır.
• Yalnızca PNG veya kayıpsız WebP çıktısı verir (her ikisi de alfa saydamlığını destekler).
• HEIC/HEIF, RAW, TGA, PSD, EXR ve HDR giriş biçimlerini otomatik çözme yoluyla destekler.