mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
2.3 KiB
2.3 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Divide l'audio per intervalli di tempo, parti uguali o rilevamento del silenzio. | c062a395dbac | human | caaeaed100a3 |
Split Audio
Divide un file audio in segmenti per intervalli di tempo fissi, parti uguali o rilevamento automatico del silenzio. Restituisce un archivio ZIP dei segmenti.
API Endpoint
POST /api/v1/tools/audio/split-audio
Accetta dati form multipart con un file audio e un campo JSON settings.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| mode | string | No | "time" |
Strategia di divisione: time, parts, silence |
| segmentS | number | No | 60 |
Lunghezza del segmento in secondi, da 1 a 3600 (usato quando la mode è time) |
| parts | integer | No | 2 |
Numero di parti uguali, da 2 a 20 (usato quando la mode è parts) |
| thresholdDb | number | No | -40 |
Soglia di silenzio in dB, da -80 a -20 (usato quando la mode è silence) |
| minSilenceS | number | No | 0.3 |
Intervallo minimo di silenzio in secondi, da 0.1 a 10 (usato quando la mode è silence) |
Example Request
Dividi in segmenti da 30 secondi:
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"mode": "time", "segmentS": 30}'
Dividi tramite rilevamento del silenzio:
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"mode": "silence", "thresholdDb": -35, "minSilenceS": 0.5}'
Example Response
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio_parts.zip",
"originalSize": 4500000,
"processedSize": 4600000
}
Notes
- Il
downloadUrlpunta a un archivio ZIP contenente tutti i segmenti. - Vengono usati solo i parametri rilevanti per la
modescelta; gli altri vengono ignorati. - I nomi dei file dei segmenti sono numerati in sequenza (ad esempio
part-000.mp3,part-001.mp3). - Il formato di output corrisponde al formato di input.