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
Fälschlich transparente PNGs mit KI-Freistellung (BiRefNet) korrigieren, um echtes Alpha zu erzeugen, plus Randbereinigung durch Defringe.	7eb748b80f93	human	dffe02a1271f

PNG-Transparenz-Korrektur

Korrigiert fälschlich transparente PNGs mit einem Klick. Nutzt KI-Freistellung (BiRefNet HR Matting-Modell), um echte Alpha-Transparenz zu erzeugen, mit Defringe-Nachbearbeitung zur Kantenbereinigung.

API-Endpunkt

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

Verarbeitung: Asynchron (liefert 202 zurück, Status über SSE per /api/v1/jobs/{jobId}/progress abrufen)

Modell-Bundle: background-removal (4-5 GB)

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
file	file	Ja	-	Bilddatei (Multipart)
defringe	number	Nein	`30`	Defringe-Intensität (0-100). Entfernt halbtransparente Randpixel um die Kanten
outputFormat	string	Nein	`"png"`	Ausgabeformat: `png` oder `webp`
removeWatermark	boolean	Nein	`false`	Wasserzeichenentfernung als Vorverarbeitung anwenden (Medianfilter)

Beispielanfrage

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

Antwort

Erste Antwort (202 Accepted)

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

Fortschritt (SSE unter `/api/v1/jobs/{jobId}/progress`)

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

Endergebnis (über 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"
  }
}

Hinweise

Erfordert die Installation des Modell-Bundles background-removal (4-5 GB).
Verwendet birefnet-hr-matting als primäres Modell für hochwertige Alpha-Freistellung. Fällt auf birefnet-general zurück, wenn dem HR-Modell der Speicher ausgeht.
Die Option defringe entfernt halbtransparente Randpixel, die die KI-Freistellung mitunter um Haare, Fell und feine Kanten hinterlässt. Sie arbeitet, indem sie den Alphakanal weichzeichnet und Pixel mit geringer Konfidenz auf null setzt.
Die Option removeWatermark wendet einen Medianfilter als Vorverarbeitungsschritt an. Es handelt sich um eine grundlegende Wasserzeichenreduzierung, nicht um ein dediziertes Werkzeug zur Wasserzeichenentfernung.
Gibt nur PNG oder verlustfreies WebP aus (beide unterstützen Alpha-Transparenz).
Unterstützt HEIC/HEIF-, RAW-, TGA-, PSD-, EXR- und HDR-Eingabeformate durch automatische Dekodierung.

3.1 KiB Raw Blame History