mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
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.
109 lines
5.1 KiB
Markdown
109 lines
5.1 KiB
Markdown
---
|
||
description: "ピクセルを再エンコードせずに、画像のEXIF、IPTC、GPS、XMP メタデータフィールドを編集します。"
|
||
i18n_source_hash: 9271d3d8f278
|
||
i18n_provenance: human
|
||
i18n_output_hash: cc4a554a90d8
|
||
---
|
||
|
||
# 画像メタデータ編集 {#edit-metadata}
|
||
|
||
EXIF、IPTC、GPS座標、日付、キーワードを含む画像メタデータフィールドを編集します。内部でExifToolを使用するため、メタデータはピクセルを再エンコードせずにその場で書き込まれ、画像品質が完全に保持されます。
|
||
|
||
## API エンドポイント {#api-endpoints}
|
||
|
||
### メタデータ編集 {#edit-metadata-1}
|
||
|
||
`POST /api/v1/tools/image/edit-metadata`
|
||
|
||
メタデータフィールドを画像に書き込み、変更されたファイルを返します。
|
||
|
||
### メタデータ検査 {#inspect-metadata}
|
||
|
||
`POST /api/v1/tools/image/edit-metadata/inspect`
|
||
|
||
ExifTool経由で画像の全メタデータをJSONとして返します。画像は変更しません。
|
||
|
||
## パラメータ（編集） {#parameters-edit}
|
||
|
||
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|
||
|-----------|------|----------|---------|-------------|
|
||
| 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 |
|
||
|
||
## リクエスト例 {#example-request}
|
||
|
||
作成者と著作権を設定:
|
||
|
||
```bash
|
||
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座標を設定:
|
||
|
||
```bash
|
||
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を削除してキーワードを追加:
|
||
|
||
```bash
|
||
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"}'
|
||
```
|
||
|
||
メタデータを検査:
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@photo.jpg"
|
||
```
|
||
|
||
## レスポンス例（編集） {#example-response-edit}
|
||
|
||
```json
|
||
{
|
||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
||
"originalSize": 2450000,
|
||
"processedSize": 2452000
|
||
}
|
||
```
|
||
|
||
## 補足 {#notes}
|
||
|
||
- このツールはサーバーにExifToolがインストールされている必要があります。Dockerイメージには含まれています。
|
||
- メタデータはその場で書き込まれるため、ピクセルの再エンコードは発生しません。ファイルサイズの変化は最小限です（メタデータのバイト分のみ）。
|
||
- `dateShift` パラメータはすべての日付フィールドを指定したオフセット分ずらします。タイムゾーンエラーの修正に便利です（例: `+02:00` または `-05:30`）。
|
||
- 変更が要求されない場合（すべてのパラメータが省略または空）、元のファイルが変更されずに返されます。
|
||
- 対応形式: JPEG、PNG、WebP、AVIF、TIFF、GIF、HEIC/HEIF。
|
||
- ブラウザでプレビューできない形式（HEIF、TIFF）の場合、レスポンスにはWebPプレビューを含む `previewUrl` フィールドが含まれます。
|