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

5.2 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Підвищення різкості зображень за допомогою адаптивного методу, маски нерізкості або високочастотного фільтра з опційним придушенням шуму.	ccb60af9faae	human	8b5f716bfdd6

Підвищення різкості

Просунутий інструмент підвищення різкості з трьома методами: адаптивний (розумне врахування країв), маска нерізкості (класичні радіус/величина) та високочастотний фільтр (акцент на текстурі). Містить вбудоване придушення шуму, щоб запобігти артефактам різкості.

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

POST /api/v1/tools/image/sharpening

Приймає багаточастинні дані форми із файлом зображення та полем JSON settings.

Параметри

Параметр	Тип	Обов’язковий	За замовчуванням	Опис
method	string	Ні	`"adaptive"`	Алгоритм підвищення різкості: `adaptive`, `unsharp-mask`, `high-pass`
sigma	number	Ні	`1.0`	Адаптивний: гаусова сигма (від 0.5 до 10)
m1	number	Ні	`1.0`	Адаптивний: підвищення різкості на рівних ділянках (від 0 до 10)
m2	number	Ні	`3.0`	Адаптивний: підвищення різкості на зубчастих ділянках (від 0 до 20)
x1	number	Ні	`2.0`	Адаптивний: поріг між рівними та зубчастими ділянками (від 0 до 10)
y2	number	Ні	`12`	Адаптивний: максимальне підвищення різкості на рівних ділянках (від 0 до 50)
y3	number	Ні	`20`	Адаптивний: максимальне підвищення різкості на зубчастих ділянках (від 0 до 50)
amount	number	Ні	`100`	Маска нерізкості: величина підвищення різкості (від 0 до 1000)
radius	number	Ні	`1.0`	Маска нерізкості: радіус розмиття у пікселях (від 0.1 до 5)
threshold	number	Ні	`0`	Маска нерізкості: мінімальна різниця яскравості для підвищення різкості (від 0 до 255)
strength	number	Ні	`50`	Високочастотний: сила фільтра (від 0 до 100)
kernelSize	number	Ні	`3`	Високочастотний: розмір ядра згортки (3 або 5)
denoise	string	Ні	`"off"`	Придушення шуму перед підвищенням різкості: `off`, `light`, `medium`, `strong`

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

curl -X POST http://localhost:1349/api/v1/tools/image/sharpening \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"method": "adaptive", "sigma": 1.5}'

Маска нерізкості з порогом для захисту гладких ділянок:

curl -X POST http://localhost:1349/api/v1/tools/image/sharpening \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"method": "unsharp-mask", "amount": 150, "radius": 1.5, "threshold": 10}'

Приклад відповіді

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2510000
}

Примітки

Використовуються лише параметри, релевантні для обраного методу. Наприклад, amount, radius та threshold ігноруються, коли method дорівнює adaptive.
Адаптивний метод використовує вбудоване адаптивне підвищення різкості Sharp із налаштовуваною поведінкою для рівних/зубчастих ділянок.
Опція denoise застосовує придушення шуму перед підвищенням різкості, щоб запобігти посиленню шуму/зернистості.
Високочастотне підвищення різкості виділяє дрібні деталі, віднімаючи розмиту версію від оригіналу, а потім знову змішуючи їх.
Формат виводу відповідає формату вводу. Вхідні файли HEIC, RAW, PSD та SVG автоматично декодуються перед обробкою.

5.2 KiB Raw Blame History