mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
---
|
||||
description: "Chia âm thanh theo khoảng thời gian, số phần bằng nhau, hoặc phát hiện im lặng."
|
||||
i18n_source_hash: c062a395dbac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 36399c884a4f
|
||||
---
|
||||
|
||||
# Split Audio {#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 {#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 {#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 {#example-request}
|
||||
|
||||
Chia thành các đoạn 30 giây:
|
||||
|
||||
```bash
|
||||
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}'
|
||||
```
|
||||
|
||||
Chia theo phát hiện im lặng:
|
||||
|
||||
```bash
|
||||
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 {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio_parts.zip",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4600000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#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.
|
||||
Reference in New Issue
Block a user