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.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Edite campos de metadados EXIF, IPTC, GPS e XMP em imagens sem recodificar os pixels.	9271d3d8f278	human	c656f50e4320

Editar Metadados da Imagem

Edite campos de metadados de imagem, incluindo EXIF, IPTC, coordenadas GPS, datas e palavras-chave. Usa o ExifTool internamente, então os metadados são gravados no local sem recodificar os pixels, preservando a qualidade total da imagem.

Endpoints da API

Editar Metadados

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

Grava campos de metadados na imagem e retorna o arquivo modificado.

Inspecionar Metadados

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

Retorna os metadados completos da imagem via ExifTool como JSON. Não modifica a imagem.

Parâmetros (Editar)

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
title	string	Não	-	Título da imagem (XMP/EXIF)
author	string	Não	-	Nome do autor
artist	string	Não	-	Nome do artista (tag Artist do EXIF)
copyright	string	Não	-	Aviso de copyright
imageDescription	string	Não	-	Descrição da imagem (EXIF)
software	string	Não	-	Tag de software
dateTime	string	Não	-	Valor DateTime do EXIF
dateTimeOriginal	string	Não	-	Valor DateTimeOriginal do EXIF
setAllDates	string	Não	-	Define todos os campos de data de uma vez
dateShift	string	Não	-	Desloca todas as datas por um deslocamento (formato: `+HH:MM` ou `-HH:MM`)
clearGps	boolean	Não	`false`	Remove todos os dados de GPS
gpsLatitude	number	Não	-	Define a latitude GPS (-90 a 90)
gpsLongitude	number	Não	-	Define a longitude GPS (-180 a 180)
gpsAltitude	number	Não	-	Define a altitude GPS em metros
keywords	string[]	Não	-	Palavras-chave/tags a adicionar ou definir
keywordsMode	string	Não	`"add"`	Como tratar as palavras-chave: `add` (anexar) ou `set` (substituir)
fieldsToRemove	string[]	Não	`[]`	Lista de nomes de campos de metadados específicos a remover
iptcTitle	string	Não	-	Nome do Objeto IPTC
iptcHeadline	string	Não	-	Manchete IPTC
iptcCity	string	Não	-	Cidade IPTC
iptcState	string	Não	-	Província/Estado IPTC
iptcCountry	string	Não	-	País IPTC

Exemplo de Requisição

Definir autor e copyright:

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

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

Remover GPS e adicionar palavras-chave:

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

Inspecionar metadados:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

Exemplo de Resposta (Editar)

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

Notas

Esta ferramenta requer que o ExifTool esteja instalado no servidor. Ele está incluído na imagem Docker.
Os metadados são gravados no local, então nenhuma recodificação de pixels ocorre. A mudança no tamanho do arquivo é mínima (apenas os bytes de metadados).
O parâmetro dateShift desloca todos os campos de data pelo deslocamento especificado, útil para corrigir erros de fuso horário (por exemplo, +02:00 ou -05:30).
Se nenhuma alteração for solicitada (todos os parâmetros omitidos ou vazios), o arquivo original é retornado inalterado.
Formatos suportados: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
Para formatos não pré-visualizáveis no navegador (HEIF, TIFF), a resposta inclui um campo previewUrl com uma pré-visualização WebP.

4.5 KiB Raw Blame History