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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
依品質層級或目標檔案大小縮減圖片檔案大小。	342c5cf1f864	human	87b36988f2d2

壓縮影像

透過指定品質層級或以 KB 為單位的目標檔案大小來縮減圖片檔案大小。此工具使用迭代式二元搜尋以精準達到大小目標。

API 端點

POST /api/v1/tools/image/compress

接受包含圖片檔案與 JSON settings 欄位的 multipart 表單資料。

參數

參數	類型	必填	預設值	說明
mode	string	否	`"quality"`	壓縮模式：`quality` 或 `targetSize`
quality	number	否	`80`	品質層級（1-100）。當模式為 `quality` 時使用。
targetSizeKb	number	否	-	以 KB 為單位的目標檔案大小。當模式為 `targetSize` 時使用。

範例請求

壓縮至品質 60：

curl -X POST http://localhost:1349/api/v1/tools/image/compress \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"mode": "quality", "quality": 60}'

壓縮至目標大小 200 KB：

curl -X POST http://localhost:1349/api/v1/tools/image/compress \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"mode": "targetSize", "targetSizeKb": 200}'

範例回應

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

備註

在 quality 模式下，數值越低，檔案越小，但壓縮失真也越多。值為 80 是網頁使用的良好預設。
在 targetSize 模式下，引擎會執行迭代壓縮，在不超過目標的前提下盡可能逼近目標。
輸出格式與輸入格式相符。壓縮套用於該格式的原生編碼（例如 JPEG 檔案用 JPEG 品質，WebP 檔案用 WebP 品質）。
若預設品質（80）可接受，可完全省略 quality 參數。

2.1 KiB Raw Blame History Unescape Escape

壓縮影像

API 端點

參數

範例請求

範例回應

備註

2.1 KiB

Raw Blame History