mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
109 lines
4.6 KiB
Markdown
109 lines
4.6 KiB
Markdown
---
|
|
description: "Bearbeitet EXIF-, IPTC-, GPS- und XMP-Metadatenfelder in Bildern, ohne die Pixel neu zu kodieren."
|
|
i18n_source_hash: a37746db11c3
|
|
i18n_provenance: human
|
|
i18n_output_hash: e0f8d58bc6c3
|
|
---
|
|
|
|
# Metadaten bearbeiten {#edit-metadata}
|
|
|
|
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 {#api-endpoints}
|
|
|
|
### Metadaten bearbeiten {#edit-metadata-1}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata`
|
|
|
|
Schreibt Metadatenfelder in das Bild und gibt die geänderte Datei zurück.
|
|
|
|
### Metadaten prüfen {#inspect-metadata}
|
|
|
|
`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) {#parameters-edit}
|
|
|
|
| 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 {#example-request}
|
|
|
|
Autor und Urheberrecht setzen:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"author": "Jane Smith", "copyright": "2024 Jane Smith"}'
|
|
```
|
|
|
|
GPS-Koordinaten setzen:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"gpsLatitude": 48.8566, "gpsLongitude": 2.3522, "gpsAltitude": 35}'
|
|
```
|
|
|
|
GPS entfernen und Schlüsselwörter hinzufügen:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"clearGps": true, "keywords": ["landscape", "sunset"], "keywordsMode": "add"}'
|
|
```
|
|
|
|
Metadaten prüfen:
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg"
|
|
```
|
|
|
|
## Beispielantwort (Bearbeiten) {#example-response-edit}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
|
"originalSize": 2450000,
|
|
"processedSize": 2452000
|
|
}
|
|
```
|
|
|
|
## Hinweise {#notes}
|
|
|
|
- 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.
|