Split Audio

Chia một tệp âm thanh thành các đoạn theo khoảng thời gian cố định, số phần bằng nhau, hoặc phát hiện im lặng tự động. Trả về một tệp lưu trữ ZIP chứa các đoạn.

API Endpoint

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

Nhận dữ liệu multipart form với một tệp âm thanh và một trường JSON settings.

Parameters

Parameter	Type	Required	Default	Description
mode	string	No	"time"	Chiến lược chia: time, parts, silence
segmentS	number	No	60	Độ dài mỗi đoạn tính bằng giây, 1 đến 3600 (dùng khi mode là time)
parts	integer	No	2	Số phần bằng nhau, 2 đến 20 (dùng khi mode là parts)
thresholdDb	number	No	-40	Ngưỡng im lặng tính bằng dB, -80 đến -20 (dùng khi mode là silence)
minSilenceS	number	No	0.3	Khoảng lặng tối thiểu tính bằng giây, 0.1 đến 10 (dùng khi mode là silence)

Example Request

Chia thành các đoạn 30 giây:

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

Chia theo phát hiện im lặng:

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

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

• downloadUrl trỏ đến một tệp lưu trữ ZIP chứa tất cả các đoạn.
• Chỉ các tham số liên quan đến mode đã chọn mới được dùng; các tham số khác bị bỏ qua.
• Tên tệp của các đoạn được đánh số tuần tự (ví dụ part-000.mp3, part-001.mp3).
• Định dạng đầu ra khớp với định dạng đầu vào.