Files
SnapOtter/apps/docs/tr/tools/audio/audio-metadata.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.3 KiB
Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Ses meta veri etiketlerini (ID3) görüntüleyin, düzenleyin veya kaldırın. 0717018e11cb human 4cef403fe66b

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 "file=@audio.mp3" \
  -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 "file=@audio.mp3" \
  -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.