Audio Metadata

Başlık, sanatçı ve albüm gibi ses meta veri etiketlerini (ID3 ve benzeri etiket formatları) görüntüleyin, düzenleyin veya kaldırın.

API Uç Noktası

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

Bir ses dosyası ve bir JSON settings alanı içeren multipart form verisini kabul eder.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
strip	boolean	Hayır	false	Mevcut tüm meta veri etiketlerini kaldır
title	string	Hayır	-	Başlık etiketini ayarla (en fazla 500 karakter)
artist	string	Hayır	-	Sanatçı etiketini ayarla (en fazla 500 karakter)
album	string	Hayır	-	Albüm etiketini ayarla (en fazla 500 karakter)

Örnek İstek

Meta veri etiketlerini düzenle:

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

Tüm meta veriyi kaldır:

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

Örnek Yanıt

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

Notlar

• Yanıt, konteyner formatı, süre, bit hızı ve mevcut etiketleri içeren bir metadata nesnesi içerir.
• strip değeri true olduğunda, tüm etiket alanları yok sayılır ve mevcut her etiket kaldırılır.
• Yalnızca sağladığınız etiketler güncellenir; belirtilmeyen etiketler değişmeden kalır.
• Çıktı formatı girdi formatıyla eşleşir.