Audio Metadata

제목, 아티스트, 앨범과 같은 오디오 메타데이터 태그(ID3 및 유사 태그 형식)를 조회, 편집 또는 제거합니다.

API 엔드포인트

POST /api/v1/tools/audio/audio-metadata

오디오 파일과 JSON settings 필드가 포함된 multipart form data를 받습니다.

파라미터

Parameter	Type	Required	Default	Description
strip	boolean	No	false	기존 메타데이터 태그를 모두 제거
title	string	No	-	제목 태그 설정(최대 500자)
artist	string	No	-	아티스트 태그 설정(최대 500자)
album	string	No	-	앨범 태그 설정(최대 500자)

요청 예시

메타데이터 태그 편집:

curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"title": "My Song", "artist": "Artist Name", "album": "Album Name"}'

모든 메타데이터 제거:

curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"strip": true}'

응답 예시

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
  "originalSize": 4500000,
  "processedSize": 4480000,
  "metadata": {
    "container": "mp3",
    "durationS": 245.3,
    "bitrateKbps": 192,
    "tags": {
      "title": "My Song",
      "artist": "Artist Name",
      "album": "Album Name"
    }
  }
}

참고

• 응답에는 컨테이너 형식, 길이, 비트레이트, 현재 태그가 담긴 metadata 객체가 포함됩니다.
• strip이 true이면 모든 태그 필드가 무시되고 기존 태그가 모두 제거됩니다.
• 제공한 태그만 업데이트되며, 지정하지 않은 태그는 변경되지 않습니다.
• 출력 형식은 입력 형식과 동일합니다.