Ses ve gerçek zamanlı
Transkripsiyon Oluştur
Sesi girdi dilinde metne dönüştürür
Mevcut transkripsiyon modellerini almak için GET /v1/models?recommended_for=stt kullanın.
İstek Gövdesi
Transkripsiyon, transkripti anında döndürebilir veya HTTP 200, id ve status ile asenkron bir görevi kabul edebilir. Kabul edilen bir görev için, döndürülen id ile GET /v1/tasks/{id} uç noktasını yoklayın. Daha uzun senkron sesler için en az 120s istemci zaman aşımına izin verin.
Transkribe edilecek ses dosyası. Desteklenen biçimler: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Maksimum dosya boyutu: 25 MB.
Transkripsiyon model kimliği (ID), örneğin whisper-large-v3 veya qwen3-asr-flash. Mevcut seçenekleri GET /v1/models?recommended_for=stt ile bulun. Varsayılan bir model yoktur.
ISO-639-1 biçiminde sesin dili (ör. en, zh, ja).
qwen3-asr-flash gibi bu parametreyi listeleyen modeller için modelin stilini yönlendirecek veya önceki bir segmenti devam ettirecek isteğe bağlı metin.
jsonÇıktı biçimi. Modeller farklılık gösterir: tümü json kabul eder ve bazıları ayrıca text veya verbose_json da listeler. Başka bir değer göndermeden önce seçilen modelin ayrıntılarını kontrol edin. text, bir JSON nesnesi yerine ham metin döndürür.
0 ile 1 arasında örnekleme sıcaklığı (sampling temperature), yalnızca bu parametreyi listeleyen modeller içindir.
Yalnızca bu parametreyi listeleyen modeller için word ve/veya segment. Bazı modeller zaman damgaları için response_format=verbose_json gerektirir. Çok parçalı (multipart) isteklerde, birden çok değer için timestamp_granularities[] parametresini tekrarlayın.
Yanıt
Aşağıdaki alanlar JSON transkript veya çeviri yanıtlarını açıklar. text, srt ve vtt, bir JSON nesnesi yerine ham metin veya altyazı döndürür. Ek alanlar modele ve çıktı biçimine bağlıdır.
Transkribe edilmiş metin.
verbose_json için:
Döndürüldüğünde görev adı, örneğin transcribe.
Algılanan dil.
Saniye cinsinden ses süresi.
Zaman damgalarıyla birlikte transkripsiyon segmentleri.
Kelime düzeyinde zaman damgaları (istenmişse).
Kabul edilen asenkron bir transkripsiyon görevi, transkript yerine aşağıdaki alanları döndürür. GET /v1/tasks/{id} uç noktasını yoklayın; tamamlanmış bir görev text ve mevcut olduğunda duration, segments ve words alanlarını döndürür.
Görev kimliği (ID).
Sağlandığında asenkron görev tanımlayıcı takma adı (alias).
Görev durumu: pending, processing, completed veya failed.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} uç noktasını yoklayın.
İstek
curl -X POST "https://api.tokenlab.sh/v1/audio/transcriptions" \
-H "Authorization: Bearer sk-your-api-key" \
-F file="@audio.mp3" \
-F model="whisper-large-v3" \
-F language="en"Yanıt
{
"text": "Hello, this is a test of the transcription API."
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
İstek gövdesi
multipart/form-data
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json