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

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

2.8 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Upptäck och gör ansikten suddiga automatiskt i bilder med AI-ansiktsigenkänning för integritet och GDPR-kompatibel anonymisering.	314e3e16a422	human	6b12ac5945fa

Gör ansikten & PII oskarpa

Upptäck och gör ansikten suddiga automatiskt i bilder med AI-driven ansiktsigenkänning (MediaPipe).

API-slutpunkt

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

Bearbetning: Asynkron (returnerar 202, hämta status genom att polla /api/v1/jobs/{jobId}/progress via SSE)

Modellpaket: face-detection (200-300 MB)

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
file	fil	Ja	-	Bildfil (multipart)
blurRadius	tal	Nej	`30`	Oskärperadie som tillämpas på upptäckta ansikten (1-100)
sensitivity	tal	Nej	`0.5`	Känslighet för ansiktsigenkänning (0-1). Lägre värden upptäcker färre ansikten med högre säkerhet

Exempelförfrågan

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

Svar

Första svaret (202 Accepted)

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

Förlopp (SSE på `/api/v1/jobs/{jobId}/progress`)

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

Slutresultat (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}
    ]
  }
}

Inga ansikten upptäckta

Om inga ansikten hittas innehåller resultatet en varning:

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

Anteckningar

Kräver att modellpaketet face-detection är installerat (200-300 MB).
Utdataformatet matchar indataformatet automatiskt.
Arrayen faces innehåller begränsningsrutans koordinater (x, y, bredd, höjd) för varje upptäckt ansikte.
Öka sensitivity (närmare 1,0) för att upptäcka fler ansikten, inklusive delvis skymda.
Stöder indataformaten HEIC/HEIF, RAW, TGA, PSD, EXR och HDR via automatisk avkodning.

2.8 KiB Raw Blame History