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
Divida o áudio por intervalos de tempo, partes iguais ou detecção de silêncio.	c062a395dbac	human	acef79f79f44

Dividir Áudio

Divida um arquivo de áudio em segmentos por intervalos de tempo fixos, partes iguais ou detecção automática de silêncio. Retorna um arquivo ZIP com os segmentos.

Endpoint da API

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

Aceita dados de formulário multipart com um arquivo de áudio e um campo JSON settings.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
mode	string	Não	`"time"`	Estratégia de divisão: `time`, `parts`, `silence`
segmentS	number	Não	`60`	Duração do segmento em segundos, 1 a 3600 (usado quando mode é `time`)
parts	integer	Não	`2`	Número de partes iguais, 2 a 20 (usado quando mode é `parts`)
thresholdDb	number	Não	`-40`	Limiar de silêncio em dB, -80 a -20 (usado quando mode é `silence`)
minSilenceS	number	Não	`0.3`	Intervalo mínimo de silêncio em segundos, 0,1 a 10 (usado quando mode é `silence`)

Exemplo de Requisição

Dividir em segmentos de 30 segundos:

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

Dividir por detecção de silêncio:

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

Exemplo de Resposta

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

Notas

O downloadUrl aponta para um arquivo ZIP contendo todos os segmentos.
Apenas os parâmetros relevantes para o mode escolhido são usados; os demais são ignorados.
Os nomes dos arquivos de segmento são numerados em sequência (ex.: part-000.mp3, part-001.mp3).
O formato de saída corresponde ao formato de entrada.

2.4 KiB Raw Blame History