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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Détecte et floute automatiquement les visages dans les images grâce à la détection de visages par IA, pour la confidentialité et une anonymisation conforme au RGPD.	fb861c12aea5	human	db97c8556891

Floutage de visages / PII

Détecte et floute automatiquement les visages dans les images grâce à la détection de visages assistée par IA (MediaPipe).

Point de terminaison de l'API

POST /api/v1/tools/image/blur-faces

Traitement : asynchrone (renvoie 202, interrogez /api/v1/jobs/{jobId}/progress pour connaître le statut via SSE)

Bundle de modèles : face-detection (200 à 300 Mo)

Paramètres

Paramètre	Type	Requis	Par défaut	Description
file	fichier	Oui	-	Fichier image (multipart)
blurRadius	nombre	Non	`30`	Rayon de flou appliqué aux visages détectés (1 à 100)
sensitivity	nombre	Non	`0.5`	Sensibilité de la détection de visages (0 à 1). Des valeurs plus faibles détectent moins de visages avec une confiance plus élevée

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/blur-faces \
  -F "file=@group-photo.jpg" \
  -F 'settings={"blurRadius":40,"sensitivity":0.3}'

Réponse

Réponse initiale (202 Accepted)

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

Progression (SSE sur `/api/v1/jobs/{jobId}/progress`)

event: progress
data: {"phase":"processing","stage":"Detecting faces...","percent":40}

Résultat final (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/group-photo_blurred.jpg",
    "originalSize": 450000,
    "processedSize": 420000,
    "facesDetected": 3,
    "faces": [
      {"x": 100, "y": 50, "w": 80, "h": 80},
      {"x": 300, "y": 60, "w": 75, "h": 75},
      {"x": 500, "y": 55, "w": 85, "h": 85}
    ]
  }
}

Aucun visage détecté

Si aucun visage n'est trouvé, le résultat inclut un avertissement :

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "facesDetected": 0,
    "warning": "No faces detected in this image. Try increasing detection sensitivity."
  }
}

Remarques

Nécessite l'installation du bundle de modèles face-detection (200 à 300 Mo).
Le format de sortie correspond automatiquement au format d'entrée.
Le tableau faces contient les coordonnées du cadre de délimitation (x, y, largeur, hauteur) de chaque visage détecté.
Augmentez sensitivity (proche de 1.0) pour détecter davantage de visages, y compris ceux partiellement masqués.
Prend en charge les formats d'entrée HEIC/HEIF, RAW, TGA, PSD, EXR et HDR via un décodage automatique.

3.0 KiB Raw Blame History