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.8 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Repariere Kratzer, Risse und Schäden an alten Fotos mit einer KI-Pipeline für Restaurierung, Gesichtsverbesserung und Farbe.	3de13284216c	human	68fa41b02608

Foto-Restaurierung

Behebe Kratzer, Risse und Schäden an alten Fotos mit einer mehrstufigen KI-Pipeline. Kombiniert Kratzerreparatur, Gesichtsverbesserung, Rauschunterdrückung und optionale Kolorierung.

API-Endpunkt

POST /api/v1/tools/image/restore-photo

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

Modell-Bundle: photo-restoration (4-5 GB)

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
file	file	Ja	-	Bilddatei (multipart)
scratchRemoval	boolean	Nein	`true`	Kratzer und Oberflächenschäden entfernen
faceEnhancement	boolean	Nein	`true`	Gesichter im restaurierten Foto verbessern
fidelity	number	Nein	`0.7`	Treue der Gesichtsverbesserung (0-1). Höhere Werte erhalten die ursprünglichen Merkmale stärker
denoise	boolean	Nein	`true`	Rauschunterdrückung auf das restaurierte Ergebnis anwenden
denoiseStrength	number	Nein	`25`	Stärke der Rauschunterdrückung (0-100)
colorize	boolean	Nein	`false`	Das restaurierte Foto kolorieren (für Graustufenbilder)
colorizeStrength	number	Nein	`85`	Intensität der Kolorierung (0-100)

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/restore-photo \
  -F "file=@damaged-old-photo.jpg" \
  -F 'settings={"scratchRemoval":true,"faceEnhancement":true,"fidelity":0.6,"colorize":true}'

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":"Removing scratches...","percent":30}

event: progress
data: {"phase":"processing","stage":"Enhancing faces...","percent":60}

Endergebnis (über SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/damaged-old-photo_restored.jpg",
    "previewUrl": "/api/v1/download/{jobId}/preview.webp",
    "originalSize": 200000,
    "processedSize": 350000,
    "width": 1200,
    "height": 900,
    "steps": ["scratch_removal", "face_enhancement", "denoise", "colorize"],
    "scratchCoverage": 12.5,
    "facesEnhanced": 2,
    "isGrayscale": true,
    "colorized": true
  }
}

Hinweise

Erfordert das installierte Modell-Bundle photo-restoration (4-5 GB).
Die Pipeline führt mehrere KI-Schritte nacheinander aus: Kratzerreparatur, Gesichtsverbesserung (GFPGAN), Rauschunterdrückung und optional Kolorierung.
Das Array steps im Ergebnis zeigt an, welche Verarbeitungsschritte tatsächlich ausgeführt wurden.
scratchCoverage ist ein geschätzter Prozentsatz der Bildfläche, die Kratzschäden aufwies.
fidelity steuert, wie stark Gesichter verbessert werden im Vergleich zur Erhaltung des ursprünglichen Aussehens. Niedrigere Werte erzeugen eine aggressivere Verbesserung; höhere Werte sind konservativer.
Die Option colorize erkennt automatisch, ob das Bild in Graustufen vorliegt. Das Flag isGrayscale im Ergebnis bestätigt diese Erkennung.
Das Ausgabeformat entspricht automatisch dem Eingabeformat.
Unterstützt die Eingabeformate HEIC/HEIF, RAW, TGA, PSD, EXR, HDR und AVIF durch automatische Dekodierung.

3.8 KiB Raw Blame History