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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Repara arañazos, roturas y daños en fotos antiguas con una canalización de IA para restauración, mejora de rostros y color.	3de13284216c	human	c888cfd7f62b

Restauración de fotos

Repara arañazos, roturas y daños en fotos antiguas mediante una canalización de IA de varios pasos. Combina la reparación de arañazos, la mejora de rostros, la reducción de ruido y la coloración opcional.

Endpoint de la API

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

Procesamiento: asíncrono (devuelve 202, consulta /api/v1/jobs/{jobId}/progress para conocer el estado vía SSE)

Paquete del modelo: photo-restoration (4-5 GB)

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
file	file	Sí	-	Archivo de imagen (multipart)
scratchRemoval	boolean	No	`true`	Eliminar arañazos y daños superficiales
faceEnhancement	boolean	No	`true`	Mejorar los rostros en la foto restaurada
fidelity	number	No	`0.7`	Fidelidad de la mejora de rostros (0-1). Los valores más altos conservan más los rasgos originales
denoise	boolean	No	`true`	Aplicar reducción de ruido al resultado restaurado
denoiseStrength	number	No	`25`	Intensidad de la reducción de ruido (0-100)
colorize	boolean	No	`false`	Colorear la foto restaurada (para imágenes en escala de grises)
colorizeStrength	number	No	`85`	Intensidad de la coloración (0-100)

Ejemplo de solicitud

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}'

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

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

Resultado final (vía 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
  }
}

Notas

Requiere que el paquete del modelo photo-restoration esté instalado (4-5 GB).
La canalización ejecuta varios pasos de IA de forma secuencial: reparación de arañazos, mejora de rostros (GFPGAN), reducción de ruido y, opcionalmente, coloración.
El array steps del resultado muestra qué pasos de procesamiento se ejecutaron realmente.
scratchCoverage es un porcentaje estimado del área de la imagen que tenía daños por arañazos.
fidelity controla con cuánta intensidad se mejoran los rostros frente a conservar la apariencia original. Los valores más bajos producen una mejora más agresiva; los valores más altos son más conservadores.
La opción colorize detecta automáticamente si la imagen está en escala de grises. El indicador isGrayscale del resultado confirma esta detección.
El formato de salida coincide automáticamente con el formato de entrada.
Admite los formatos de entrada HEIC/HEIF, RAW, TGA, PSD, EXR, HDR y AVIF mediante decodificación automática.

3.9 KiB Raw Blame History