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

3.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Автоматичне виявлення та розмиття облич на зображеннях за допомогою ШІ-виявлення облич для конфіденційності та GDPR-сумісної анонімізації.	314e3e16a422	human	bd07b81e5727

Розмиття облич та ПД

Автоматичне виявлення та розмиття облич на зображеннях за допомогою виявлення облич на основі ШІ (MediaPipe).

Кінцева точка API

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

Обробка: Асинхронна (повертає 202, опитуйте /api/v1/jobs/{jobId}/progress щодо статусу через SSE)

Пакет моделі: face-detection (200-300 МБ)

Параметри

Параметр	Тип	Обов'язковий	Типове значення	Опис
file	file	Так	-	Файл зображення (multipart)
blurRadius	number	Ні	`30`	Радіус розмиття, застосований до виявлених облич (1-100)
sensitivity	number	Ні	`0.5`	Чутливість виявлення облич (0-1). Нижчі значення виявляють менше облич з вищою впевненістю

Приклад запиту

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

Відповідь

Початкова відповідь (202 Accepted)

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

Перебіг (SSE за адресою `/api/v1/jobs/{jobId}/progress`)

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

Кінцевий результат (через 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}
    ]
  }
}

Обличчя не виявлено

Якщо обличчя не знайдено, результат містить попередження:

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

Примітки

Потребує встановлення пакета моделі face-detection (200-300 МБ).
Вихідний формат автоматично відповідає вхідному.
Масив faces містить координати обмежувальної рамки (x, y, ширина, висота) для кожного виявленого обличчя.
Збільшіть sensitivity (ближче до 1.0), щоб виявити більше облич, зокрема частково закриті.
Підтримує вхідні формати HEIC/HEIF, RAW, TGA, PSD, EXR та HDR через автоматичне декодування.

3.7 KiB Raw Blame History