mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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

4.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Edita campos de metadatos EXIF, IPTC, GPS y XMP en imágenes sin recodificar los píxeles.	9271d3d8f278	human	9ee294905c8a

Editar metadatos de imagen

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 "file=@photo.jpg" \
  -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 "file=@photo.jpg" \
  -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 "file=@photo.jpg" \
  -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 "file=@photo.jpg"

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.

4.6 KiB Raw Blame History