SnapOtter/apps/docs/zh-TW/tools/image/strip-metadata.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
從影像移除 EXIF、GPS、ICC 與 XMP 中繼資料，以保護隱私並縮小檔案大小。	e89147734fd0	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。