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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
從影像移除 EXIF、GPS、ICC 與 XMP 中繼資料，以保護隱私並縮小檔案大小。	07f61cdb2c26	human	11185204026f

移除影像中繼資料

從影像移除 EXIF、GPS、ICC 色彩描述檔與 XMP 中繼資料。適用於保護隱私（移除 GPS 座標、相機資訊）以及縮小檔案大小。

API 端點

移除中繼資料

POST /api/v1/tools/image/strip-metadata

處理影像並回傳已移除所選中繼資料的乾淨版本。

檢視中繼資料

POST /api/v1/tools/image/strip-metadata/inspect

以 JSON 回傳解析後的中繼資料，不會修改影像。適用於在移除之前預覽存在哪些中繼資料。

參數（移除）

參數	型別	必填	預設值	說明
stripExif	boolean	否	`false`	移除 EXIF 資料（相機設定、日期等）
stripGps	boolean	否	`false`	只移除 GPS/位置資料
stripIcc	boolean	否	`false`	移除 ICC 色彩描述檔
stripXmp	boolean	否	`false`	移除 XMP 中繼資料（Adobe、IPTC）
stripAll	boolean	否	`true`	一次移除所有中繼資料

當 stripAll 為 true 時，會覆寫個別旗標並移除全部內容。

範例請求

移除所有中繼資料：

curl -X POST http://localhost:1349/api/v1/tools/image/strip-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"stripAll": true}'

只移除 GPS 資料（保留相機資訊與色彩描述檔）：

curl -X POST http://localhost:1349/api/v1/tools/image/strip-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"stripAll": false, "stripGps": true}'

檢視中繼資料而不修改：

curl -X POST http://localhost:1349/api/v1/tools/image/strip-metadata/inspect \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

範例回應（移除）

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

範例回應（檢視）

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "exif": {
    "Make": "Canon",
    "Model": "EOS R5",
    "DateTimeOriginal": "2024:03:15 14:30:00",
    "ExposureTime": "1/250",
    "FNumber": 2.8,
    "ISO": 400
  },
  "gps": {
    "GPSLatitudeRef": "N",
    "GPSLatitude": [37, 46, 30],
    "_latitude": 37.775,
    "_longitude": -122.4183
  },
  "icc": {
    "Profile Size": "3144 bytes",
    "Color Space": "RGB",
    "Description": "sRGB IEC61966-2.1"
  },
  "xmp": {
    "CreatorTool": "Adobe Photoshop 25.0"
  }
}

注意事項

移除後影像會以其原始格式重新編碼。JPEG 使用 mozjpeg 以品質 90 編碼，PNG 使用壓縮等級 9，WebP 使用品質 85。
若影像原本標記為非 sRGB 描述檔，移除 ICC 描述檔可能造成細微的色彩偏移。若在意色彩準確度，請使用 stripIcc: false。
檢視端點會將 GPS 座標解析為十進位的緯度/經度值（以底線為前綴），以便使用。
支援的輸入格式：JPEG、PNG、WebP、AVIF、TIFF、GIF。

3.4 KiB Raw Blame History Unescape Escape