# Türkçe konuşmayı metne çevirme API’si

> KolWrite ile Türkçe ses ve video dosyalarını tek bir REST çağrısıyla metne çevirebilirsiniz. Dosyanın URL’sini "language": "tr" ile gönderdiğinizde, kelime zaman damgaları ve konuşmacı etiketleri içeren segmentler JSON, TXT veya SRT biçiminde döner. Oracle modelleriyle aynı işlemde Türkçe konuşmayı İngilizceye, Almancaya ya da desteklenen 100 dilden herhangi birine de çevirebilirsiniz.

Son güncelleme: 2026-11-21 · HTML: https://console.kolwrite.com/tr/speech-to-text/turkish

## Tek istekle Türkçe transkripsiyon

`language` değerini `tr` yapıp işi başlatın. Sonucu `GET /transcribe/{jobId}` ile alabilir ya da önceden bir `webhook_url` verebilirsiniz.

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/gorusme-tr.m4a", "model": "oracle", "language": "tr", "include_diarization": true, "output_format": "json"}'
```

Aynı işlemde Türkçe sesi İngilizceye çevirmek için (yalnızca Oracle modelleri):

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/gorusme-tr.m4a", "model": "oracle_mini", "language": "tr", "translate_to": "en", "word_timestamps": false, "output_format": "srt"}'
```

## Bir bakışta Türkçe

| Özellik | Ayrıntı |
| --- | --- |
| API’deki kod | `tr` |
| Kendi dilindeki adı | Türkçe |
| Yazı yönü | Soldan sağa |
| Otomatik algılama | Var: `language` alanını boş bırakın veya `"auto"` gönderin |
| Türkçe sesin çevrilebildiği diller | Oracle modellerinde desteklenen 100 dilden herhangi biri |
| Diğer dillerden Türkçeye çeviri | Var: Oracle modellerinde `translate_to: "tr"` |
| Çıktı | JSON (segmentler, kelime zamanları, konuşmacılar), TXT, SRT |
| Fiyat | Ses saati başına 0,48 (Base) ile 3,60 (Oracle Max) ABD doları arasında; Oracle için 1,44 ABD doları |

## Türkçe transkripsiyonda bilmeniz gerekenler

- Türkçede noktalı ve noktasız i ayrı harflerdir (İ/i ve I/ı). Standart küçük harfe çevirme kelimeleri bozar; arama için dizin oluştururken `toLocaleLowerCase("tr")` gibi Türkçe kurallarını bilen bir yöntem kullanın.
- Türkçe sondan eklemeli bir dildir: tek bir kelime köküne art arda birden fazla ek gelebilir. Arama ve anahtar kelime yakalamada tam kelime yerine kök (stem) eşleştirmek daha iyi sonuç verir.
- Özel isimlere gelen ekler kesme işaretiyle ayrılır (İstanbul’da, Ayşe’nin). Metni kelimelere bölen bir tokenizer kullanıyorsanız, kesme işaretinden bölünen özel isimlerin eşleşmesini ayrıca kontrol edin.
- Almanya ve Hollanda’daki Türkçe konuşanlar konuşmalarına sık sık Almanca ya da Felemenkçe sözcükler katar. Ses ağırlıklı olarak Türkçeyse `tr` gönderin.
- SRT dosyalarını UTF-8 olarak açın. Eski oynatıcı ve düzenleyicilerde varsayılan olan Windows-1254 gibi kodlamalar ğ, ş, ı, İ gibi harfleri bozabilir.

## Türkçe transkripsiyon kullanım alanları

- Türkçe yayınlar, podcast’ler ve YouTube videoları için altyazı.
- Türkiye’deki ve Avrupa’da yaşayan Türk topluluğuna hizmet veren çağrı merkezleri.
- `translate_to` ile İngilizceye veya Almancaya çevrilen röportajlar.

## Model seçimi

Canlı ortamda (production) Türkçe ses için `oracle` ile başlayın (saati 1,44 ABD doları). Temiz ve tek konuşmacılı kayıtlarda büyük hacim işliyorsanız `base` (0,48 ABD doları) yeterlidir. En ucuz çeviri için `oracle_mini` (0,96 ABD doları), gürültülü ya da zor kayıtlar için `oracle_pro` veya `oracle_max` kullanın. KolWrite bu API için Türkçeye özel bir doğruluk oranı yayımlamaz; karar vermeden önce kendi kayıtlarınızdan bir örnekle deneme yapın. Tüm karşılaştırma için [modeller ve fiyatlar](https://console.kolwrite.com/models) sayfasına (İngilizce) bakın.

## Sık sorulan sorular

### Türkçe transkriptlerimde arama neden bazı kelimeleri bulamıyor?

Çoğunlukla büyük/küçük harf dönüşümü yüzünden olur: "I".toLowerCase() sonucu "ı" değildir. Dönüşümde Türkçe locale (`tr-TR`) kullanın ve arama için kelimeleri köklerine ayırın (stemming).

### Türkçe sesi Almancaya çevirebilir miyim?

Evet. Bir Oracle modeli ile `translate_to: "de"` kullanın.

### Hangi modelle başlamalıyım?

Canlı ortamdaki ses kayıtları için `oracle`, temiz ve tek konuşmacılı kayıtlar için `base`.

## İlgili sayfalar

- [Almanca konuşmayı metne çevirme API’si](https://console.kolwrite.com/de/speech-to-text/german)
- [Arapça konuşmayı metne çevirme API’si](https://console.kolwrite.com/ar/speech-to-text/arabic)
- [Medya, podcast ve altyazı kullanım alanı (İngilizce sayfa)](https://console.kolwrite.com/use-cases/media)
- [Çağrı merkezi kullanım alanı (İngilizce sayfa)](https://console.kolwrite.com/use-cases/call-centers)
- [Desteklenen diller (İngilizce sayfa)](https://console.kolwrite.com/languages/)

---
API anahtarı al: https://console.kolwrite.com/auth · API dokümantasyonu: https://console.kolwrite.com/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
