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,49 @@
|
||||
---
|
||||
description: "Mono ve stereo arasında dönüştürün veya sol ve sağ kanalları değiştirin."
|
||||
i18n_source_hash: 4f5cd6b38c83
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c63d35c99a7
|
||||
---
|
||||
|
||||
# Audio Channels {#audio-channels}
|
||||
|
||||
Sesi mono ve stereo düzenler arasında dönüştürün veya bir stereo dosyanın sol ve sağ kanallarını değiştirin.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-channels`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Evet | - | Kanal işlemi: `stereo-to-mono`, `mono-to-stereo`, `swap` |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-channels \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"mode": "stereo-to-mono"}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2300000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- `stereo-to-mono` her iki kanalı tek bir mono parçaya karıştırır.
|
||||
- `mono-to-stereo` mono kanalı hem sola hem de sağa çoğaltır.
|
||||
- `swap` bir stereo dosyanın sol ve sağ kanallarını takas eder.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,73 @@
|
||||
---
|
||||
description: "Ses meta veri etiketlerini (ID3) görüntüleyin, düzenleyin veya kaldırın."
|
||||
i18n_source_hash: 0717018e11cb
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4cef403fe66b
|
||||
---
|
||||
|
||||
# Audio Metadata {#audio-metadata}
|
||||
|
||||
Başlık, sanatçı ve albüm gibi ses meta veri etiketlerini (ID3 ve benzeri etiket formatları) görüntüleyin, düzenleyin veya kaldırın.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-metadata`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strip | boolean | Hayır | `false` | Mevcut tüm meta veri etiketlerini kaldır |
|
||||
| title | string | Hayır | - | Başlık etiketini ayarla (en fazla 500 karakter) |
|
||||
| artist | string | Hayır | - | Sanatçı etiketini ayarla (en fazla 500 karakter) |
|
||||
| album | string | Hayır | - | Albüm etiketini ayarla (en fazla 500 karakter) |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
Meta veri etiketlerini düzenle:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"title": "My Song", "artist": "Artist Name", "album": "Album Name"}'
|
||||
```
|
||||
|
||||
Tüm meta veriyi kaldır:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"strip": true}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4480000,
|
||||
"metadata": {
|
||||
"container": "mp3",
|
||||
"durationS": 245.3,
|
||||
"bitrateKbps": 192,
|
||||
"tags": {
|
||||
"title": "My Song",
|
||||
"artist": "Artist Name",
|
||||
"album": "Album Name"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- Yanıt, konteyner formatı, süre, bit hızı ve mevcut etiketleri içeren bir `metadata` nesnesi içerir.
|
||||
- `strip` değeri `true` olduğunda, tüm etiket alanları yok sayılır ve mevcut her etiket kaldırılır.
|
||||
- Yalnızca sağladığınız etiketler güncellenir; belirtilmeyen etiketler değişmeden kalır.
|
||||
- Çıktı formatı girdi formatıyla eşleşir.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Bir çarpanla ses oynatmayı hızlandırın veya yavaşlatın."
|
||||
i18n_source_hash: e39ba662e594
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 14e07fbc6592
|
||||
---
|
||||
|
||||
# Audio Speed {#audio-speed}
|
||||
|
||||
Bir hız çarpanı uygulayarak ses oynatmayı hızlandırın veya yavaşlatın.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-speed`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| factor | number | Hayır | `1.5` | Hız çarpanı (0.25 ile 4 arası). 1'in altındaki değerler yavaşlatır; üstündekiler hızlandırır. |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-speed \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"factor": 2}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2250000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- `0.25` çarpanı çeyrek hızda oynatır (4 kat daha uzun). `4` çarpanı dört kat hızda oynatır (4 kat daha kısa).
|
||||
- Hız değişirken perde (pitch) korunur (zaman esnetme). Perdeyi bağımsız olarak ayarlamak için perde kaydırmayı (pitch-shift) kullanın.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Sesi MP3, WAV, OGG, FLAC ve M4A formatları arasında dönüştürün."
|
||||
i18n_source_hash: fd02c059e6a9
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 90b93fea4b4c
|
||||
---
|
||||
|
||||
# Convert Audio {#convert-audio}
|
||||
|
||||
Ses dosyalarını MP3, WAV, OGG, FLAC ve M4A dahil yaygın formatlar arasında, yapılandırılabilir çıktı bit hızıyla dönüştürün.
|
||||
|
||||
## 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ı) |
|
||||
|
||||
## Ö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" \
|
||||
-F 'settings={"format": "flac", "bitrateKbps": 256}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 8200000
|
||||
}
|
||||
```
|
||||
|
||||
## 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.
|
||||
- Çıktı dosya adı, orijinal adı yeni uzantıyla korur.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Sese içeri ve dışarı solma efektleri ekleyin."
|
||||
i18n_source_hash: 86856451ecb8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c5f9238bb1dd
|
||||
---
|
||||
|
||||
# Fade Audio {#fade-audio}
|
||||
|
||||
Bir ses dosyasının başına ve sonuna içeri solma (fade-in) ve dışarı solma (fade-out) efektleri ekleyin.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/fade-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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| fadeInS | number | Hayır | `1` | Saniye cinsinden içeri solma süresi (0 ile 30 arası) |
|
||||
| fadeOutS | number | Hayır | `1` | Saniye cinsinden dışarı solma süresi (0 ile 30 arası) |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/fade-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"fadeInS": 2, "fadeOutS": 3}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- O solma yönünü atlamak için değerlerden birini `0` olarak ayarlayın. En az biri 0'dan büyük olmalıdır.
|
||||
- Solma süresi, ses uzunluğunu aşarsa ona kırpılır.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
description: "Birden çok ses dosyasını tek bir ardışık parçaya birleştirin."
|
||||
i18n_source_hash: defa993d3f87
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 78e097ceb639
|
||||
---
|
||||
|
||||
# Merge Audio {#merge-audio}
|
||||
|
||||
İki veya daha fazla ses dosyasını, yüklendikleri sırada birleştirilmiş tek bir ardışık parçada birleştirin.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/merge-audio`
|
||||
|
||||
Birden çok 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`, `flac`, `m4a` |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/merge-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@intro.mp3" \
|
||||
-F "file=@main.mp3" \
|
||||
-F "file=@outro.mp3" \
|
||||
-F 'settings={"format": "mp3"}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
|
||||
"originalSize": 9500000,
|
||||
"processedSize": 9200000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- İstek başına 2 ile 10 ses dosyası kabul eder.
|
||||
- Dosyalar yükleme sırasına göre birleştirilir.
|
||||
- Tüm girdi dosyaları, kusursuz birleştirme için seçilen çıktı formatına ve örnekleme hızına yeniden kodlanır.
|
||||
- Karışık girdi formatları desteklenir (ör. bir WAV ve bir MP3).
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "FFT tabanlı gürültü giderme ile sesteki arka plan gürültüsünü azaltın."
|
||||
i18n_source_hash: 57cbdbd449aa
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1a57429f8c46
|
||||
---
|
||||
|
||||
# Noise Reduction {#noise-reduction}
|
||||
|
||||
Seçilebilir güçle FFT tabanlı gürültü giderme kullanarak bir ses dosyasındaki arka plan gürültüsünü azaltın.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/noise-reduction`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strength | string | Hayır | `"medium"` | Gürültü giderme gücü: `light`, `medium`, `strong` |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/noise-reduction \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"strength": "strong"}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- `light` daha fazla ayrıntı korur ancak daha az gürültü giderir. `strong` daha fazla gürültü giderir ancak ince yapaylıklar (artifact) katabilir.
|
||||
- Tutarlı arka plan gürültüsü (fan uğultusu, klima, statik) içeren kayıtlarda en iyi sonuçları verir.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Ses yüksekliğini yayın standardı seviyelerine (EBU R128) eşitleyin."
|
||||
i18n_source_hash: 794d8cfa5ad8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e5d9db14541e
|
||||
---
|
||||
|
||||
# Normalize Audio {#normalize-audio}
|
||||
|
||||
EBU R128 normalleştirmesini (-16 LUFS) kullanarak ses yüksekliğini yayın standardı seviyelerine eşitleyin.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/normalize-audio`
|
||||
|
||||
Bir ses dosyası ve bir JSON `settings` alanı içeren multipart form verisini kabul eder.
|
||||
|
||||
## Parametreler {#parameters}
|
||||
|
||||
Bu aracın yapılandırılabilir parametresi yoktur. EBU R128 yükseklik normalleştirmesini otomatik olarak uygular.
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/normalize-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3"
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- -16 LUFS'i hedefleyen EBU R128 yükseklik standardını kullanır.
|
||||
- Tutarlı yüksekliğin önemli olduğu podcast'ler, sesli kitaplar ve yayın içeriği için idealdir.
|
||||
- Kaynak örnekleme hızı çıktıda korunur.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Hızı değiştirmeden ses perdesini yarım tonlarla yükseltin veya düşürün."
|
||||
i18n_source_hash: 2804d0eeecc8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d2adc9bc2ba7
|
||||
---
|
||||
|
||||
# Pitch Shift {#pitch-shift}
|
||||
|
||||
Bir ses dosyasının perdesini, oynatma hızını değiştirmeden belirli sayıda yarım ton yükseltin veya düşürün.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/pitch-shift`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| semitones | integer | Hayır | `3` | Kaydırılacak yarım ton (-12 ile 12 arası). Sıfır olmamalıdır. |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/pitch-shift \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"semitones": -5}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- Pozitif değerler perdeyi yükseltir; negatif değerler düşürür.
|
||||
- 12 yarım tonluk bir kaydırma bir oktav yukarıya eşittir; -12 bir oktav aşağıya eşittir.
|
||||
- Kaydırma miktarından bağımsız olarak oynatma süresi aynı kalır.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
description: "Bir ses dosyasını geriye doğru çalacak şekilde tersine çevirin."
|
||||
i18n_source_hash: 5c2017661803
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0e1a166d2681
|
||||
---
|
||||
|
||||
# Reverse Audio {#reverse-audio}
|
||||
|
||||
Bir ses dosyasını geriye doğru çalacak şekilde tersine çevirin.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/reverse-audio`
|
||||
|
||||
Bir ses dosyası ve bir JSON `settings` alanı içeren multipart form verisini kabul eder.
|
||||
|
||||
## Parametreler {#parameters}
|
||||
|
||||
Bu aracın yapılandırılabilir parametresi yoktur. Ses dosyasının tamamı tersine çevrilir.
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/reverse-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3"
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- Ses parçasının tamamı sondan başa doğru tersine çevrilir.
|
||||
- Çıktı genellikle girdi konteynerini korur. AAC girdisi M4A olarak yazılır ve desteklenmeyen yalnızca-çözümleme (decode-only) girdileri MP3'e geri döner.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Herhangi bir ses dosyasından bir zil sesi klibi oluşturun."
|
||||
i18n_source_hash: 8fcdcc545fbc
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d45c381ebf34
|
||||
---
|
||||
|
||||
# Ringtone Maker {#ringtone-maker}
|
||||
|
||||
Bir başlangıç zamanı ve süre seçerek herhangi bir ses dosyasından bir zil sesi klibi (.m4r) oluşturun.
|
||||
|
||||
## API Uç Noktası {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/ringtone-maker`
|
||||
|
||||
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 |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | Hayır | `0` | Saniye cinsinden başlangıç zamanı (en az 0) |
|
||||
| durationS | number | Hayır | `30` | Saniye cinsinden klip süresi (1 ile 30 arası) |
|
||||
|
||||
## Örnek İstek {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/ringtone-maker \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"startS": 15, "durationS": 20}'
|
||||
```
|
||||
|
||||
## Örnek Yanıt {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 620000
|
||||
}
|
||||
```
|
||||
|
||||
## Notlar {#notes}
|
||||
|
||||
- Çıktı her zaman M4R formatındadır ve iPhone zil sesleriyle uyumludur.
|
||||
- Maksimum zil sesi süresi 30 saniyedir (Apple sınırı).
|
||||
- Girdi olarak herhangi bir ses formatı kullanılabilir.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Bir ses dosyasından sessiz bölümleri çıkarın."
|
||||
i18n_source_hash: a7624fc99b50
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: dbad2fe62e7b
|
||||
---
|
||||
|
||||
# Silence Removal {#silence-removal}
|
||||
|
||||
Yapılandırılabilir bir eşik ve minimum süreye göre bir ses dosyasındaki sessiz bölümleri algılayın ve kaldırın.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/silence-removal`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| thresholdDb | number | No | `-50` | dB cinsinden sessizlik eşiği (-80 ile -20 arası). Bu seviyenin altındaki ses sessiz kabul edilir. |
|
||||
| minSilenceS | number | No | `0.5` | Kaldırılacak saniye cinsinden minimum sessizlik süresi (0.1 ile 5 arası) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/silence-removal \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"thresholdDb": -45, "minSilenceS": 1}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 3200000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Daha yüksek (daha az negatif) bir eşik daha agresiftir ve gerçek sessizliğin yanı sıra daha sessiz pasajları da kaldırır.
|
||||
- Yalnızca daha uzun duraklamaları çıkarmak, kısa doğal boşlukları korumak için `minSilenceS` değerini artırın.
|
||||
- Podcast kayıtlarını, dersleri ve sesli notları temizlemek için kullanışlıdır.
|
||||
- Çıktı genellikle giriş konteynerini korur. AAC girişi M4A olarak yazılır ve desteklenmeyen yalnızca-çözme girişleri MP3'e geri döner.
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
description: "Sesi zaman aralıklarına, eşit parçalara veya sessizlik algılamaya göre bölün."
|
||||
i18n_source_hash: c062a395dbac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 587c89692229
|
||||
---
|
||||
|
||||
# Split Audio {#split-audio}
|
||||
|
||||
Bir ses dosyasını sabit zaman aralıklarına, eşit parçalara veya otomatik sessizlik algılamaya göre segmentlere bölün. Segmentleri içeren bir ZIP arşivi döndürür.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/split-audio`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | No | `"time"` | Bölme stratejisi: `time`, `parts`, `silence` |
|
||||
| segmentS | number | No | `60` | Saniye cinsinden segment uzunluğu, 1 ile 3600 arası (mod `time` olduğunda kullanılır) |
|
||||
| parts | integer | No | `2` | Eşit parça sayısı, 2 ile 20 arası (mod `parts` olduğunda kullanılır) |
|
||||
| thresholdDb | number | No | `-40` | dB cinsinden sessizlik eşiği, -80 ile -20 arası (mod `silence` olduğunda kullanılır) |
|
||||
| minSilenceS | number | No | `0.3` | Saniye cinsinden minimum sessizlik boşluğu, 0.1 ile 10 arası (mod `silence` olduğunda kullanılır) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
30 saniyelik segmentlere böl:
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
Sessizlik algılamaya göre böl:
|
||||
|
||||
```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` tüm segmentleri içeren bir ZIP arşivine işaret eder.
|
||||
- Yalnızca seçilen `mode` ile ilgili parametreler kullanılır; diğerleri yok sayılır.
|
||||
- Segment dosya adları sıralı olarak numaralandırılır (ör. `part-000.mp3`, `part-001.mp3`).
|
||||
- Çıktı formatı giriş formatıyla eşleşir.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Yapay zeka destekli transkripsiyon ile konuşmayı metne dönüştürün."
|
||||
i18n_source_hash: ae98c4c0aed2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ff100c40114a
|
||||
---
|
||||
|
||||
# Transcribe Audio {#transcribe-audio}
|
||||
|
||||
Yapay zeka destekli transkripsiyon (faster-whisper) kullanarak konuşmayı metne dönüştürün. Otomatik veya manuel dil seçimiyle düz metin, SRT ve VTT çıktı formatlarını destekler.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/transcribe-audio`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| language | string | No | `"auto"` | Dil: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
|
||||
| outputFormat | string | No | `"txt"` | Çıktı formatı: `txt`, `srt`, `vtt` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/transcribe-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"language": "en", "outputFormat": "srt"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Bu asenkron bir araçtır. API hemen `202 Accepted` döndürür:
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
İlerlemeyi `GET /api/v1/jobs/{jobId}/progress` adresinde SSE üzerinden izleyin. İş tamamlandığında, SSE akışı nihai sonucu bir `downloadUrl` ile birlikte teslim eder.
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- **transcription** özellik paketinin kurulu olmasını gerektirir. Paket kullanılabilir değilse `FEATURE_NOT_INSTALLED` koduyla `501`, eksik `feature`, `featureName` ve `estimatedSize` döndürür.
|
||||
- Transkripsiyon için faster-whisper kullanır. `auto` dili konuşulan dili otomatik olarak algılar.
|
||||
- `srt` ve `vtt` formatları her segment için zaman damgaları içerir ve altyazılar için uygundur.
|
||||
- `txt` formatı zaman damgası olmadan düz metin döndürür.
|
||||
- Bu uzun süren bir yapay zeka aracıdır; işleme süresi ses uzunluğuna ve sunucu donanımına bağlıdır.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Başlangıç ve bitiş sürelerini belirterek bir ses dosyasından bir bölüm kesin."
|
||||
i18n_source_hash: 8b80c5c8a711
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9dc1f95749c1
|
||||
---
|
||||
|
||||
# Trim Audio {#trim-audio}
|
||||
|
||||
Saniye cinsinden başlangıç ve bitiş sürelerini belirterek bir ses dosyasından bir bölüm kesin.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/trim-audio`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | No | `0` | Saniye cinsinden başlangıç zamanı (minimum 0) |
|
||||
| endS | number | Yes | - | Saniye cinsinden bitiş zamanı (başlangıçtan sonra olmalıdır) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/trim-audio \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"startS": 10, "endS": 45}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 1575000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Süreler saniye cinsinden belirtilir ve ondalık içerebilir (ör. `10.5`).
|
||||
- `endS` değeri `startS` değerinden büyük olmalıdır.
|
||||
- `endS` ses süresini aşarsa, dosya sonuna kadar kırpılır.
|
||||
- Çıktı genellikle giriş konteynerini korur. AAC girişi M4A olarak yazılır ve desteklenmeyen yalnızca-çözme girişleri MP3'e geri döner.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Ses seviyesini desibel cinsinden sabit bir kazançla artırın veya azaltın."
|
||||
i18n_source_hash: b9bc1de2c9ef
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7103af0b532c
|
||||
---
|
||||
|
||||
# Volume Adjust {#volume-adjust}
|
||||
|
||||
Desibel cinsinden sabit bir kazanç uygulayarak bir ses dosyasının ses seviyesini artırın veya azaltın.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/volume-adjust`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| gainDb | number | No | `3` | Desibel cinsinden ses ayarı (-30 ile 30 arası) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/volume-adjust \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"gainDb": 6}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Pozitif değerler ses seviyesini artırır; negatif değerler azaltır.
|
||||
- Büyük pozitif kazançlar kırpılmaya (clipping) neden olabilir. Ses seviyesi açısından güvenli dengeleme için normalize-audio kullanın.
|
||||
- Çıktı genellikle giriş konteynerini korur. AAC girişi M4A olarak yazılır ve desteklenmeyen yalnızca-çözme girişleri MP3'e geri döner.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Bir ses dosyasından PNG görüntüsü olarak bir dalga formu görselleştirmesi oluşturun."
|
||||
i18n_source_hash: 5480106dfe48
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4ce8f81111c7
|
||||
---
|
||||
|
||||
# Waveform Image {#waveform-image}
|
||||
|
||||
Yapılandırılabilir boyutlar ve renkle, bir ses dosyasından PNG görüntüsü olarak bir dalga formu görselleştirmesi oluşturun.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/waveform-image`
|
||||
|
||||
Bir ses dosyası ve JSON `settings` alanı içeren multipart form verisi kabul eder.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| width | integer | No | `1024` | Piksel cinsinden görüntü genişliği (256 ile 3840 arası) |
|
||||
| height | integer | No | `256` | Piksel cinsinden görüntü yüksekliği (64 ile 1080 arası) |
|
||||
| color | string | No | `"#4f46e5"` | Dalga formu hex rengi (ör. `"#4f46e5"`) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/audio/waveform-image \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@audio.mp3" \
|
||||
-F 'settings={"width": 1920, "height": 400, "color": "#e07832"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.png",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 45000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Giriş ses formatından bağımsız olarak çıktı her zaman bir PNG görüntüsüdür.
|
||||
- Dalga formu saydam bir arka plan üzerine işlenir.
|
||||
- Küçük resimler, sosyal medya önizlemeleri veya web sayfalarına gömme için kullanışlıdır.
|
||||
Reference in New Issue
Block a user