Files
SnapOtter/apps/docs/ru/tools/image/strip-metadata.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

4.9 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Удаление метаданных EXIF, GPS, ICC и XMP из изображений для приватности и уменьшения размера файла. e89147734fd0 human 3bc878783056

Удаление метаданных

Удалите метаданные 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.
  • Удаление профилей ICC может вызвать незначительные сдвиги цвета, если изображение было помечено профилем, отличным от sRGB. Используйте stripIcc: false, если важна точность цвета.
  • Конечная точка просмотра разбирает GPS-координаты в десятичные значения широты/долготы (с префиксом подчёркивания) для удобства.
  • Поддерживаемые входные форматы: JPEG, PNG, WebP, AVIF, TIFF, GIF.