2026-07-11 13:52:47 +08:00
---
description : "Sesi MP3, WAV, OGG, FLAC ve M4A formatları arası nda dönüştürün."
2026-07-18 10:14:50 +08:00
i18n_source_hash : 27fd2f49f472
2026-07-11 13:52:47 +08:00
i18n_provenance : human
i18n_output_hash : 90b93fea4b4c
---
# Convert Audio {#convert-audio}
2026-07-18 10:14:50 +08:00
Ses dosyaları nı MP3, WAV, OGG, FLAC ve M4A dahil yaygı n formatlar arası nda, yapı landı rı labilir çıktı bit hı zı ve örnekleme hı zı yla dönüştürün.
2026-07-11 13:52:47 +08:00
## API Uç Noktası {#api-endpoint}
`POST /api/v1/tools/audio/convert-audio`
Bir ses dosyası ve bir JSON `settings` alanı içeren multipart form verisini kabul eder.
## Parametreler {#parameters}
| Parametre | Tür | Zorunlu | Varsayı lan | Açıklama |
|-----------|------|----------|---------|-------------|
| format | string | Hayı r | `"mp3"` | Çıktı formatı : `mp3` , `wav` , `ogg` , `flac` , `m4a` |
| bitrateKbps | integer | Hayı r | `192` | kbps cinsinden çıktı bit hı zı (32 ile 320 arası ) |
2026-07-18 10:14:50 +08:00
| sampleRate | integer | Hayı r | kaynak hı zı | Hz cinsinden çıktı örnekleme hı zı : `8000` , `16000` , `22050` , `32000` , `44100` , `48000` veya `96000` . Kaynak hı zı nı korumak için atlayı n |
2026-07-11 13:52:47 +08:00
## Örnek İstek {#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" \
2026-07-18 10:14:50 +08:00
-F 'settings={"format": "mp3", "bitrateKbps": 192, "sampleRate": 44100}'
2026-07-11 13:52:47 +08:00
```
## Örnek Yanı t {#example-response}
```json
{
"jobId" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ,
2026-07-18 10:14:50 +08:00
"downloadUrl" : "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3" ,
2026-07-11 13:52:47 +08:00
"originalSize" : 4500000 ,
2026-07-18 10:14:50 +08:00
"processedSize" : 2800000
2026-07-11 13:52:47 +08:00
}
```
## Notlar {#notes}
- Desteklenen girdi formatları arası nda MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF ve OPUS bulunur.
- Bit hı zı yalnı zca kayı plı formatlar (MP3, OGG, M4A) için geçerlidir. WAV ve FLAC gibi kayı psı z formatlar bu ayarı yok sayar.
2026-07-18 10:14:50 +08:00
- MP3 çıktı sı 48000 Hz'e kadar örnekleme hı zları nı destekler. 96000 Hz seçeneği yalnı zca WAV, OGG, FLAC ve M4A için geçerlidir.
- MP3 bit hı zı örnekleme hı zı na göre sı nı rlı dı r: 8000 Hz'de en fazla 64 kbps, 16000 veya 22050 Hz'de ise en fazla 160 kbps. Sı nı rı n üzerindeki istekler sessizce düşürülmek yerine reddedilir.
2026-07-11 13:52:47 +08:00
- Çıktı dosya adı , orijinal adı yeni uzantı yla korur.