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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Görüntülerde EXIF, IPTC, GPS ve XMP meta veri alanlarını piksel yeniden kodlaması olmadan düzenleyin.	9271d3d8f278	human	1ba065328abd

Görüntü Meta Verisi Düzenle

EXIF, IPTC, GPS koordinatları, tarihler ve anahtar kelimeler dahil olmak üzere görüntü meta veri alanlarını düzenleyin. Arka planda ExifTool kullanır, bu nedenle meta veriler pikselleri yeniden kodlamadan yerinde yazılır ve tam görüntü kalitesi korunur.

API Uç Noktaları

Meta Veri Düzenle

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

Meta veri alanlarını görüntüye yazar ve değiştirilen dosyayı döndürür.

Meta Veriyi İncele

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

Görüntüden tam meta veriyi ExifTool aracılığıyla JSON olarak döndürür. Görüntüyü değiştirmez.

Parametreler (Düzenle)

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
title	string	Hayır	-	Görüntü başlığı (XMP/EXIF)
author	string	Hayır	-	Yazar adı
artist	string	Hayır	-	Sanatçı adı (EXIF Artist etiketi)
copyright	string	Hayır	-	Telif hakkı bildirimi
imageDescription	string	Hayır	-	Görüntü açıklaması (EXIF)
software	string	Hayır	-	Yazılım etiketi
dateTime	string	Hayır	-	EXIF DateTime değeri
dateTimeOriginal	string	Hayır	-	EXIF DateTimeOriginal değeri
setAllDates	string	Hayır	-	Tüm tarih alanlarını bir kerede ayarla
dateShift	string	Hayır	-	Tüm tarihleri ofset kadar kaydır (biçim: `+HH:MM` veya `-HH:MM`)
clearGps	boolean	Hayır	`false`	Tüm GPS verilerini kaldır
gpsLatitude	number	Hayır	-	GPS enlemini ayarla (-90 ile 90 arası)
gpsLongitude	number	Hayır	-	GPS boylamını ayarla (-180 ile 180 arası)
gpsAltitude	number	Hayır	-	GPS yüksekliğini metre cinsinden ayarla
keywords	string[]	Hayır	-	Eklenecek veya ayarlanacak anahtar kelimeler/etiketler
keywordsMode	string	Hayır	`"add"`	Anahtar kelimelerin nasıl işleneceği: `add` (ekle) veya `set` (değiştir)
fieldsToRemove	string[]	Hayır	`[]`	Kaldırılacak belirli meta veri alanı adlarının listesi
iptcTitle	string	Hayır	-	IPTC Object Name
iptcHeadline	string	Hayır	-	IPTC Headline
iptcCity	string	Hayır	-	IPTC City
iptcState	string	Hayır	-	IPTC Province/State
iptcCountry	string	Hayır	-	IPTC Country

Örnek İstek

Yazar ve telif hakkını ayarla:

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 koordinatlarını ayarla:

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'i kaldır ve anahtar kelimeler ekle:

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

Meta veriyi incele:

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

Örnek Yanıt (Düzenle)

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

Notlar

Bu araç, sunucuda ExifTool'un kurulu olmasını gerektirir. Docker imajına dahildir.
Meta veriler yerinde yazılır, bu nedenle piksel yeniden kodlaması gerçekleşmez. Dosya boyutu değişikliği minimaldir (yalnızca meta veri baytları).
dateShift parametresi, tüm tarih alanlarını belirtilen ofset kadar kaydırır ve saat dilimi hatalarını düzeltmek için kullanışlıdır (örn. +02:00 veya -05:30).
Hiçbir değişiklik istenmezse (tüm parametreler atlanmış veya boşsa), orijinal dosya değiştirilmeden döndürülür.
Desteklenen biçimler: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
Tarayıcıda önizlenemeyen biçimler (HEIF, TIFF) için yanıt, WebP önizlemesi içeren bir previewUrl alanı içerir.

4.7 KiB Raw Blame History Unescape Escape