Découper l'audio

Découpe un fichier audio en segments par intervalles de temps fixes, parts égales ou détection automatique du silence. Renvoie une archive ZIP des segments.

Point de terminaison de l'API

POST /api/v1/tools/audio/split-audio

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

Paramètres

Paramètre	Type	Requis	Par défaut	Description
mode	string	Non	"time"	Stratégie de découpage : time, parts, silence
segmentS	number	Non	60	Longueur de segment en secondes, 1 à 3600 (utilisé lorsque le mode est time)
parts	integer	Non	2	Nombre de parts égales, 2 à 20 (utilisé lorsque le mode est parts)
thresholdDb	number	Non	-40	Seuil de silence en dB, -80 à -20 (utilisé lorsque le mode est silence)
minSilenceS	number	Non	0.3	Écart de silence minimal en secondes, 0,1 à 10 (utilisé lorsque le mode est silence)

Exemple de requête

Découper en segments de 30 secondes :

curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"mode": "time", "segmentS": 30}'

Découper par détection de silence :

curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"mode": "silence", "thresholdDb": -35, "minSilenceS": 0.5}'

Exemple de réponse

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio_parts.zip",
  "originalSize": 4500000,
  "processedSize": 4600000
}

Remarques

• Le downloadUrl pointe vers une archive ZIP contenant tous les segments.
• Seuls les paramètres pertinents pour le mode choisi sont utilisés ; les autres sont ignorés.
• Les noms de fichiers des segments sont numérotés de façon séquentielle (par ex. part-000.mp3, part-001.mp3).
• Le format de sortie correspond au format d'entrée.