mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Consulter, modifier ou supprimer les balises de métadonnées audio (ID3).	0717018e11cb	human	a4a43115a499

Métadonnées audio

Consulter, modifier ou supprimer les balises de métadonnées audio telles que le titre, l'artiste et l'album (formats de balises ID3 et similaires).

Point de terminaison de l'API

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

Accepte des données de formulaire multipart avec un fichier audio et un champ JSON settings.

Paramètres

Paramètre	Type	Requis	Défaut	Description
strip	boolean	Non	`false`	Supprimer toutes les balises de métadonnées existantes
title	string	Non	-	Définir la balise de titre (500 caractères max)
artist	string	Non	-	Définir la balise d'artiste (500 caractères max)
album	string	Non	-	Définir la balise d'album (500 caractères max)

Exemple de requête

Modifier les balises de métadonnées :

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

Supprimer toutes les métadonnées :

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

Exemple de réponse

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

Notes

La réponse inclut un objet metadata avec le format du conteneur, la durée, le débit et les balises actuelles.
Lorsque strip vaut true, tous les champs de balises sont ignorés et chaque balise existante est supprimée.
Seules les balises que vous fournissez sont mises à jour ; les balises non spécifiées restent inchangées.
Le format de sortie correspond au format d'entrée.

2.4 KiB Raw Blame History