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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
使用自适应、USM 锐化或高通方法锐化图像，并可选降噪。	66dce4068899	human	8096d6bf1ecd

锐化图片

提供三种方法的高级锐化工具：自适应（智能边缘感知）、USM 锐化（经典的半径/强度）和高通（纹理强化）。内置降噪功能，可防止锐化产生伪影。

API 端点

POST /api/v1/tools/image/sharpening

接受包含图像文件和 JSON settings 字段的 multipart 表单数据。

参数

参数	类型	必填	默认值	说明
method	string	否	`"adaptive"`	锐化算法：`adaptive`、`unsharp-mask`、`high-pass`
sigma	number	否	`1.0`	自适应：高斯 sigma（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`	USM 锐化：锐化强度（0 到 1000）
radius	number	否	`1.0`	USM 锐化：模糊半径（像素，0.1 到 5）
threshold	number	否	`0`	USM 锐化：触发锐化的最小亮度差（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}'

使用阈值保护平滑区域的 USM 锐化：

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
}

说明

仅使用与所选方法相关的参数。例如，当 method 为 adaptive 时，amount、radius 和 threshold 会被忽略。
自适应方法使用 Sharp 内置的自适应锐化，可配置平坦/锯齿区域的行为。
denoise 选项在锐化前应用降噪，以防止放大噪点/颗粒。
高通锐化通过从原图中减去模糊版本来提取细节，然后再混合回原图。
输出格式与输入格式一致。HEIC、RAW、PSD 和 SVG 输入在处理前会自动解码。

3.0 KiB Raw Blame History Unescape Escape

锐化图片

API 端点

参数

示例请求

示例响应

说明

3.0 KiB

Raw Blame History