mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
d4eaa655b2
The Convert Audio tool promised configurable bitrate, sample rate, and channel count, but only format and bitrate were exposed. Adds an optional sampleRate setting (8000 to 96000 Hz, omitted = preserve source) wired through the Zod schema, the FFmpeg -ar flag, the standalone settings panel, and the pipeline builder controls. Impossible combinations fail loudly instead of degrading silently: MP3 + 96000 Hz is rejected (libmp3lame caps at 48 kHz), and MP3 bitrates above the encoder ceiling at low rates (64 kbps at 8 kHz, 160 kbps at 16/22.05 kHz) are rejected rather than clamped. The UI offers only legal combinations and sanitizes stored pipeline settings on load. Docs updated in English plus all 20 localized pages with refreshed i18n_source_hash stamps; two new UI strings added to all 21 locales. Fixes #558
53 lines
3.0 KiB
Markdown
53 lines
3.0 KiB
Markdown
---
|
||
description: "Преобразование аудио между форматами MP3, WAV, OGG, FLAC и M4A."
|
||
i18n_source_hash: 27fd2f49f472
|
||
i18n_provenance: human
|
||
i18n_output_hash: 23fa00361fd5
|
||
---
|
||
|
||
# Преобразование аудио {#convert-audio}
|
||
|
||
Преобразуйте аудиофайлы между распространёнными форматами, включая MP3, WAV, OGG, FLAC и M4A, с настраиваемым выходным битрейтом и частотой дискретизации.
|
||
|
||
## Конечная точка API {#api-endpoint}
|
||
|
||
`POST /api/v1/tools/audio/convert-audio`
|
||
|
||
Принимает данные формы multipart с аудиофайлом и полем `settings` в формате JSON.
|
||
|
||
## Параметры {#parameters}
|
||
|
||
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|
||
|-----------|------|----------|---------|-------------|
|
||
| format | string | Нет | `"mp3"` | Выходной формат: `mp3`, `wav`, `ogg`, `flac`, `m4a` |
|
||
| bitrateKbps | integer | Нет | `192` | Выходной битрейт в кбит/с (от 32 до 320) |
|
||
| sampleRate | integer | Нет | исходная частота | Выходная частота дискретизации в Гц: `8000`, `16000`, `22050`, `32000`, `44100`, `48000` или `96000`. Не указывайте, чтобы сохранить исходную частоту |
|
||
|
||
## Пример запроса {#example-request}
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/audio/convert-audio \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@audio.mp3" \
|
||
-F 'settings={"format": "mp3", "bitrateKbps": 192, "sampleRate": 44100}'
|
||
```
|
||
|
||
## Пример ответа {#example-response}
|
||
|
||
```json
|
||
{
|
||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||
"originalSize": 4500000,
|
||
"processedSize": 2800000
|
||
}
|
||
```
|
||
|
||
## Примечания {#notes}
|
||
|
||
- Поддерживаемые входные форматы включают MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF и OPUS.
|
||
- Битрейт применяется только к форматам с потерями (MP3, OGG, M4A). Форматы без потерь, такие как WAV и FLAC, игнорируют эту настройку.
|
||
- Вывод в MP3 поддерживает частоту дискретизации до 48000 Гц. Значение 96000 Гц применяется только к WAV, OGG, FLAC и M4A.
|
||
- Битрейт MP3 ограничен частотой дискретизации: не более 64 кбит/с при 8000 Гц и 160 кбит/с при 16000 или 22050 Гц. Запросы выше этого ограничения отклоняются, а не понижаются без предупреждения.
|
||
- Имя выходного файла сохраняет исходное имя с новым расширением.
|