SnapOtter/apps/docs/ja/tools/image/edit-metadata.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
ピクセルを再エンコードせずに、画像のEXIF、IPTC、GPS、XMP メタデータフィールドを編集します。	a37746db11c3	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 フィールドが含まれます。