메타데이터 편집

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 "[email protected]" \
  -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 "[email protected]" \
  -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 "[email protected]" \
  -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 "[email protected]"

응답 예시 (편집)

{
  "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 필드가 포함됩니다.