mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

3.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Napraw fałszywie przezroczyste pliki PNG za pomocą mattingu AI (BiRefNet), aby uzyskać prawdziwy kanał alfa, plus czyszczenie krawędzi metodą defringe.	7eb748b80f93	human	e85aa5b620ef

Naprawianie przezroczystości PNG

Napraw fałszywie przezroczyste pliki PNG jednym kliknięciem. Wykorzystuje matting AI (model BiRefNet HR Matting), aby uzyskać prawdziwą przezroczystość alfa, z przetwarzaniem końcowym defringe do oczyszczania krawędzi.

Punkt końcowy API

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

Przetwarzanie: Asynchroniczne (zwraca 202, odpytuj /api/v1/jobs/{jobId}/progress o status przez SSE)

Pakiet modeli: background-removal (4-5 GB)

Parametry

Parametr	Typ	Wymagany	Domyślny	Opis
file	file	Tak	-	Plik obrazu (multipart)
defringe	number	Nie	`30`	Intensywność defringe (0-100). Usuwa półprzezroczyste piksele obwódki wokół krawędzi
outputFormat	string	Nie	`"png"`	Format wyjściowy: `png` lub `webp`
removeWatermark	boolean	Nie	`false`	Zastosuj przetwarzanie wstępne usuwające znak wodny (filtr medianowy)

Przykładowe żądanie

curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
  -F "file=@fake-transparent.png" \
  -F 'settings={"defringe":40,"outputFormat":"png"}'

Odpowiedź

Wstępna odpowiedź (202 Accepted)

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

Postęp (SSE pod `/api/v1/jobs/{jobId}/progress`)

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

Wynik końcowy (przez 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"
  }
}

Uwagi

Wymaga zainstalowania pakietu modeli background-removal (4-5 GB).
Używa birefnet-hr-matting jako podstawowego modelu do wysokiej jakości mattingu alfa. Wraca do birefnet-general, jeśli modelowi HR zabraknie pamięci.
Opcja defringe usuwa półprzezroczyste piksele obwódki, które matting AI czasem pozostawia wokół włosów, futra i drobnych krawędzi. Działa przez rozmycie kanału alfa i wyzerowanie pikseli o niskiej pewności.
Opcja removeWatermark stosuje krok przetwarzania wstępnego z filtrem medianowym. Jest to podstawowa redukcja znaku wodnego, a nie dedykowane narzędzie do jego usuwania.
Wyprowadza wyłącznie PNG lub bezstratny WebP (oba obsługują przezroczystość alfa).
Obsługuje formaty wejściowe HEIC/HEIF, RAW, TGA, PSD, EXR i HDR poprzez automatyczne dekodowanie.

3.1 KiB Raw Blame History