Files
SnapOtter/apps/docs/it/tools/image/strip-metadata.md
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.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Rimuove i metadati EXIF, GPS, ICC e XMP dalle immagini per privacy e file di dimensioni più ridotte. 07f61cdb2c26 human 5276921c50db

Rimuovi metadati immagine

Rimuove i metadati EXIF, GPS, i profili colore ICC e i metadati XMP dalle immagini. Utile per la privacy (rimozione di coordinate GPS, informazioni sulla fotocamera) e per ridurre le dimensioni del file.

Endpoint API

Rimuovi metadati

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

Elabora l'immagine e restituisce una versione ripulita con i metadati selezionati rimossi.

Ispeziona metadati

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

Restituisce i metadati analizzati come JSON senza modificare l'immagine. Utile per visualizzare in anteprima quali metadati esistono prima della rimozione.

Parametri (Rimozione)

Parametro Tipo Obbligatorio Predefinito Descrizione
stripExif boolean No false Rimuove i dati EXIF (impostazioni della fotocamera, date, ecc.)
stripGps boolean No false Rimuove solo i dati GPS/di posizione
stripIcc boolean No false Rimuove il profilo colore ICC
stripXmp boolean No false Rimuove i metadati XMP (Adobe, IPTC)
stripAll boolean No true Rimuove tutti i metadati in una volta

Quando stripAll è true, sovrascrive i singoli flag e rimuove tutto.

Esempio di richiesta

Rimuovi tutti i metadati:

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}'

Rimuovi solo i dati GPS (mantieni informazioni sulla fotocamera e profilo colore):

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}'

Ispeziona i metadati senza modificare:

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

Esempio di risposta (Rimozione)

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

Esempio di risposta (Ispezione)

{
  "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"
  }
}

Note

  • L'immagine viene ricodificata nel suo formato originale dopo la rimozione. JPEG usa mozjpeg alla qualità 90, PNG usa il livello di compressione 9, WebP usa la qualità 85.
  • La rimozione dei profili ICC può causare lievi variazioni di colore se l'immagine era contrassegnata con un profilo non sRGB. Usa stripIcc: false se la precisione del colore è importante.
  • L'endpoint di ispezione analizza le coordinate GPS in valori decimali di latitudine/longitudine (con prefisso underscore) per comodità.
  • Formati di input supportati: JPEG, PNG, WebP, AVIF, TIFF, GIF.