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

5.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
ピクセルを再エンコードせずに、画像のEXIF、IPTC、GPS、XMP メタデータフィールドを編集します。	9271d3d8f278	human	cc4a554a90d8

画像メタデータ編集

EXIF、IPTC、GPS座標、日付、キーワードを含む画像メタデータフィールドを編集します。内部でExifToolを使用するため、メタデータはピクセルを再エンコードせずにその場で書き込まれ、画像品質が完全に保持されます。

API エンドポイント

メタデータ編集

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

メタデータフィールドを画像に書き込み、変更されたファイルを返します。

メタデータ検査

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

ExifTool経由で画像の全メタデータをJSONとして返します。画像は変更しません。

パラメータ（編集）

パラメータ	型	必須	デフォルト	説明
title	string	いいえ	-	画像タイトル（XMP/EXIF）
author	string	いいえ	-	作成者名
artist	string	いいえ	-	アーティスト名（EXIF Artistタグ）
copyright	string	いいえ	-	著作権表示
imageDescription	string	いいえ	-	画像の説明（EXIF）
software	string	いいえ	-	ソフトウェアタグ
dateTime	string	いいえ	-	EXIF DateTime値
dateTimeOriginal	string	いいえ	-	EXIF DateTimeOriginal値
setAllDates	string	いいえ	-	すべての日付フィールドを一度に設定
dateShift	string	いいえ	-	すべての日付をオフセット分ずらす（形式: `+HH:MM` または `-HH:MM`）
clearGps	boolean	いいえ	`false`	すべてのGPSデータを削除
gpsLatitude	number	いいえ	-	GPS緯度を設定（-90〜90）
gpsLongitude	number	いいえ	-	GPS経度を設定（-180〜180）
gpsAltitude	number	いいえ	-	GPS高度をメートル単位で設定
keywords	string[]	いいえ	-	追加または設定するキーワード/タグ
keywordsMode	string	いいえ	`"add"`	キーワードの扱い方: `add`（追加）または `set`（置換）
fieldsToRemove	string[]	いいえ	`[]`	削除する特定のメタデータフィールド名のリスト
iptcTitle	string	いいえ	-	IPTC Object Name
iptcHeadline	string	いいえ	-	IPTC Headline
iptcCity	string	いいえ	-	IPTC City
iptcState	string	いいえ	-	IPTC Province/State
iptcCountry	string	いいえ	-	IPTC Country

リクエスト例

作成者と著作権を設定:

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座標を設定:

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を削除してキーワードを追加:

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

メタデータを検査:

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

レスポンス例（編集）

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

補足

このツールはサーバーにExifToolがインストールされている必要があります。Dockerイメージには含まれています。
メタデータはその場で書き込まれるため、ピクセルの再エンコードは発生しません。ファイルサイズの変化は最小限です（メタデータのバイト分のみ）。
dateShift パラメータはすべての日付フィールドを指定したオフセット分ずらします。タイムゾーンエラーの修正に便利です（例: +02:00 または -05:30）。
変更が要求されない場合（すべてのパラメータが省略または空）、元のファイルが変更されずに返されます。
対応形式: JPEG、PNG、WebP、AVIF、TIFF、GIF、HEIC/HEIF。
ブラウザでプレビューできない形式（HEIF、TIFF）の場合、レスポンスにはWebPプレビューを含む previewUrl フィールドが含まれます。

5.1 KiB Raw Blame History Unescape Escape