Corrector de transparencia PNG

Corrige PNG con falsa transparencia con un solo clic. Usa matting por IA (modelo BiRefNet HR Matting) para producir una transparencia alfa real, con postprocesamiento de defringe para limpiar los bordes.

API Endpoint

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

Procesamiento: Asíncrono (devuelve 202, sondea /api/v1/jobs/{jobId}/progress para conocer el estado mediante SSE)

Paquete de modelos: background-removal (4-5 GB)

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
file	file	Sí	-	Archivo de imagen (multipart)
defringe	number	No	30	Intensidad de defringe (0-100). Elimina los píxeles de franja semitransparente alrededor de los bordes
outputFormat	string	No	"png"	Formato de salida: png o webp
removeWatermark	boolean	No	false	Aplica un preprocesamiento de eliminación de marca de agua (filtro de mediana)

Ejemplo de solicitud

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

Respuesta

Respuesta inicial (202 Accepted)

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

Progreso (SSE en /api/v1/jobs/{jobId}/progress)

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

Resultado final (mediante 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"
  }
}

Notas

• Requiere que el paquete de modelos background-removal esté instalado (4-5 GB).
• Usa birefnet-hr-matting como modelo principal para un matting alfa de alta calidad. Recurre a birefnet-general si el modelo HR se queda sin memoria.
• La opción defringe elimina los píxeles de franja semitransparente que el matting por IA a veces deja alrededor del cabello, el pelaje y los bordes finos. Funciona desenfocando el canal alfa y poniendo a cero los píxeles de baja confianza.
• La opción removeWatermark aplica un paso de preprocesamiento con filtro de mediana. Es una reducción básica de marcas de agua, no una herramienta dedicada a la eliminación de marcas de agua.
• Solo produce PNG o WebP sin pérdida (ambos admiten transparencia alfa).
• Admite los formatos de entrada HEIC/HEIF, RAW, TGA, PSD, EXR y HDR mediante decodificación automática.