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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
以 AI 臉部偵測自動偵測並模糊影像中的臉部，用於隱私保護及符合 GDPR 的匿名化。	314e3e16a422	human	94edf3daf65b

模糊臉部與隱私資訊

使用 AI 驅動的臉部偵測（MediaPipe）自動偵測並模糊影像中的臉部。

API Endpoint

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

處理方式： 非同步（回傳 202，透過 SSE 輪詢 /api/v1/jobs/{jobId}/progress 取得狀態）

模型套件： face-detection（200-300 MB）

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	影像檔案（multipart）
blurRadius	number	No	`30`	套用於偵測到臉部的模糊半徑（1-100）
sensitivity	number	No	`0.5`	臉部偵測靈敏度（0-1）。較低的值以較高的信心偵測較少的臉部

Example Request

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

Response

Initial Response (202 Accepted)

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

Progress (SSE at `/api/v1/jobs/{jobId}/progress`)

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

Final Result (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}
    ]
  }
}

No Faces Detected

若未找到臉部，結果會包含一則警告：

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

Notes

需要安裝 face-detection 模型套件（200-300 MB）。
輸出格式會自動與輸入格式相符。
faces 陣列包含每個偵測到臉部的邊界框座標（x、y、width、height）。
增加 sensitivity（越接近 1.0）以偵測更多臉部，包含部分被遮擋的臉部。
透過自動解碼支援 HEIC/HEIF、RAW、TGA、PSD、EXR 及 HDR 輸入格式。

2.7 KiB Raw Blame History Unescape Escape