Editar metadatos

Edita campos de metadatos de imagen, incluidos EXIF, IPTC, coordenadas GPS, fechas y palabras clave. Usa ExifTool internamente, por lo que los metadatos se escriben en el sitio sin recodificar los píxeles, preservando la calidad completa de la imagen.

Endpoints de la API

Editar metadatos

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

Escribe campos de metadatos en la imagen y devuelve el archivo modificado.

Inspeccionar metadatos

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

Devuelve todos los metadatos de la imagen mediante ExifTool como JSON. No modifica la imagen.

Parámetros (Editar)

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
title	string	No	-	Título de la imagen (XMP/EXIF)
author	string	No	-	Nombre del autor
artist	string	No	-	Nombre del artista (etiqueta EXIF Artist)
copyright	string	No	-	Aviso de derechos de autor
imageDescription	string	No	-	Descripción de la imagen (EXIF)
software	string	No	-	Etiqueta de software
dateTime	string	No	-	Valor EXIF DateTime
dateTimeOriginal	string	No	-	Valor EXIF DateTimeOriginal
setAllDates	string	No	-	Establece todos los campos de fecha a la vez
dateShift	string	No	-	Desplaza todas las fechas por un valor de compensación (formato: +HH:MM o -HH:MM)
clearGps	boolean	No	false	Elimina todos los datos GPS
gpsLatitude	number	No	-	Establece la latitud GPS (-90 a 90)
gpsLongitude	number	No	-	Establece la longitud GPS (-180 a 180)
gpsAltitude	number	No	-	Establece la altitud GPS en metros
keywords	string[]	No	-	Palabras clave/etiquetas que se añaden o establecen
keywordsMode	string	No	"add"	Cómo tratar las palabras clave: add (añadir) o set (reemplazar)
fieldsToRemove	string[]	No	[]	Lista de nombres específicos de campos de metadatos que se eliminan
iptcTitle	string	No	-	IPTC Object Name
iptcHeadline	string	No	-	IPTC Headline
iptcCity	string	No	-	IPTC City
iptcState	string	No	-	IPTC Province/State
iptcCountry	string	No	-	IPTC Country

Ejemplo de solicitud

Establecer autor y derechos de autor:

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

Establecer coordenadas GPS:

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

Eliminar GPS y añadir palabras clave:

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

Inspeccionar metadatos:

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

Ejemplo de respuesta (Editar)

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

Notas

• Esta herramienta requiere que ExifTool esté instalado en el servidor. Está incluido en la imagen de Docker.
• Los metadatos se escriben en el sitio, por lo que no se produce recodificación de píxeles. El cambio en el tamaño del archivo es mínimo (solo los bytes de metadatos).
• El parámetro dateShift desplaza todos los campos de fecha por la compensación especificada, útil para corregir errores de zona horaria (p. ej. +02:00 o -05:30).
• Si no se solicitan cambios (todos los parámetros omitidos o vacíos), el archivo original se devuelve sin cambios.
• Formatos admitidos: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
• Para los formatos que no se pueden previsualizar en el navegador (HEIF, TIFF), la respuesta incluye un campo previewUrl con una vista previa WebP.