Ses ve gerçek zamanlı

Transkripsiyon Oluştur

Sesi girdi dilinde metne dönüştürür

POST
/v1/audio/transcriptions

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.

filefilezorunlu

Transkribe edilecek ses dosyası. Desteklenen biçimler: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Maksimum dosya boyutu: 25 MB.

modelstringzorunlu

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.

languagestring

ISO-639-1 biçiminde sesin dili (ör. en, zh, ja).

promptstring

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.

response_formatstringvarsayılan: 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.

temperaturenumber

0 ile 1 arasında örnekleme sıcaklığı (sampling temperature), yalnızca bu parametreyi listeleyen modeller içindir.

timestamp_granularitiesarray

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.

textstring

Transkribe edilmiş metin.

verbose_json için:

taskstring

Döndürüldüğünde görev adı, örneğin transcribe.

languagestring

Algılanan dil.

durationnumber

Saniye cinsinden ses süresi.

segmentsarray

Zaman damgalarıyla birlikte transkripsiyon segmentleri.

wordsarray

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.

idstring

Görev kimliği (ID).

task_idstring

Sağlandığında asenkron görev tanımlayıcı takma adı (alias).

statusstring

Görev durumu: pending, processing, completed veya failed.

poll_urlstring

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
AuthorizationBearer <token>

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

X-TokenLab-Delivery-Policy?string

İ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