Metadaten bearbeiten

Bearbeitet Bildmetadatenfelder einschließlich EXIF, IPTC, GPS-Koordinaten, Daten und Schlüsselwörter. Verwendet ExifTool im Hintergrund, sodass Metadaten direkt geschrieben werden, ohne die Pixel neu zu kodieren, wodurch die volle Bildqualität erhalten bleibt.

API-Endpunkte

Metadaten bearbeiten

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

Schreibt Metadatenfelder in das Bild und gibt die geänderte Datei zurück.

Metadaten prüfen

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

Gibt die vollständigen Metadaten des Bildes über ExifTool als JSON zurück. Verändert das Bild nicht.

Parameter (Bearbeiten)

Parameter	Typ	Erforderlich	Standard	Beschreibung
title	string	Nein	-	Bildtitel (XMP/EXIF)
author	string	Nein	-	Name des Autors
artist	string	Nein	-	Name des Künstlers (EXIF-Artist-Tag)
copyright	string	Nein	-	Urheberrechtshinweis
imageDescription	string	Nein	-	Bildbeschreibung (EXIF)
software	string	Nein	-	Software-Tag
dateTime	string	Nein	-	EXIF-DateTime-Wert
dateTimeOriginal	string	Nein	-	EXIF-DateTimeOriginal-Wert
setAllDates	string	Nein	-	Alle Datumsfelder auf einmal setzen
dateShift	string	Nein	-	Alle Daten um einen Versatz verschieben (Format: +HH:MM oder -HH:MM)
clearGps	boolean	Nein	false	Alle GPS-Daten entfernen
gpsLatitude	number	Nein	-	GPS-Breitengrad setzen (-90 bis 90)
gpsLongitude	number	Nein	-	GPS-Längengrad setzen (-180 bis 180)
gpsAltitude	number	Nein	-	GPS-Höhe in Metern setzen
keywords	string[]	Nein	-	Hinzuzufügende oder zu setzende Schlüsselwörter/Tags
keywordsMode	string	Nein	"add"	Umgang mit Schlüsselwörtern: add (anhängen) oder set (ersetzen)
fieldsToRemove	string[]	Nein	[]	Liste bestimmter zu entfernender Metadatenfeldnamen
iptcTitle	string	Nein	-	IPTC Object Name
iptcHeadline	string	Nein	-	IPTC Headline
iptcCity	string	Nein	-	IPTC City
iptcState	string	Nein	-	IPTC Province/State
iptcCountry	string	Nein	-	IPTC Country

Beispielanfrage

Autor und Urheberrecht setzen:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"author": "Jane Smith", "copyright": "2024 Jane Smith"}'

GPS-Koordinaten setzen:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"gpsLatitude": 48.8566, "gpsLongitude": 2.3522, "gpsAltitude": 35}'

GPS entfernen und Schlüsselwörter hinzufügen:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"clearGps": true, "keywords": ["landscape", "sunset"], "keywordsMode": "add"}'

Metadaten prüfen:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]"

Beispielantwort (Bearbeiten)

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

Hinweise

• Dieses Werkzeug erfordert, dass ExifTool auf dem Server installiert ist. Es ist im Docker-Image enthalten.
• Metadaten werden direkt geschrieben, sodass keine erneute Pixelkodierung erfolgt. Die Änderung der Dateigröße ist minimal (nur die Metadaten-Bytes).
• Der Parameter dateShift verschiebt alle Datumsfelder um den angegebenen Versatz, was zur Korrektur von Zeitzonenfehlern nützlich ist (z. B. +02:00 oder -05:30).
• Werden keine Änderungen angefordert (alle Parameter weggelassen oder leer), wird die Originaldatei unverändert zurückgegeben.
• Unterstützte Formate: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
• Für Formate, die nicht im Browser vorschaubar sind (HEIF, TIFF), enthält die Antwort ein Feld previewUrl mit einer WebP-Vorschau.