TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Ses ve gerçek zamanlı

Transkripsiyon Oluştur

Sesi giriş diline transkribe eder

POST
/v1/audio/transcriptions

İstek Gövdesi

Transkripsiyon metni doğrudan döndürebilir veya HTTP 200, id ve status ile asenkron bir görevi kabul edebilir. Kabul edilen görev için poll_url adresini izleyin ya da /v1/tasks/{id} sorgulayın. Uzun sesin senkron işlenmesinde en az 120s zaman aşımı kullanın.

filefilezorunlu

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

modelstringvarsayılan: whisper-1

Transkripsiyon model ID’si; örneğin whisper-1 veya gpt-4o-transcribe. Güncel seçenekleri GET /v1/models?recommended_for=stt ile bulun.

languagestring

Sesin dili, ISO-639-1 formatında (ör. en, zh, ja).

promptstring

Modelin stilini yönlendirmek veya önceki bir segmenti devam ettirmek için isteğe bağlı metin.

response_formatstringvarsayılan: json

Çıktı biçimi. Whisper json, text, srt, verbose_json ve vtt destekler; diğer modeller farklı seçenekler sunabilir. Model ayrıntılarını kontrol edin.

temperaturenumber

0 ile 1 arasında örnekleme sıcaklığı; yalnızca bu parametreyi destekleyen modeller için.

timestamp_granularitiesarray

Model destekliyorsa word ve/veya segment. Whisper için response_format=verbose_json gerekir. Multipart isteklerde birden fazla değer için timestamp_granularities[] alanını tekrarlayın.

Yanıt

Aşağıdaki alanlar JSON transkripsiyon veya çeviri yanıtlarını açıklar. text, srt ve vtt, JSON nesnesi yerine ham metin veya altyazı döndürür. Ek alanlar modele ve çıktı biçimine bağlıdır.

textstring

Transkribe edilen metin.

verbose_json için:

taskstring

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

languagestring

Algılanan dil.

durationnumber

Ses süresi, saniye cinsinden.

segmentsarray

Zaman damgalarıyla birlikte transkripsiyon segmentleri.

wordsarray

Kelime düzeyinde zaman damgaları (istenirse).

Kabul edilen asenkron transkripsiyon görevi, metin yerine aşağıdaki alanları döndürür:

idstring

Görev ID'si.

task_idstring

Uygun olduğunda dönen asenkron görev kimliği takma adı.

statusstring

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

poll_urlstring

Oluşturma yanıtı sağladığında tercih edilen yoklama URL’si.

İ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-1" \
  -F language="en"

Yanıt

{
  "text": "Hello, this is a test of the transcription API."
}

Çeviri

Sesi İngilizceye çevirmek için translations endpoint'ini kullanın:

with open("audio.mp3", "rb") as audio_file:
    response = client.audio.translations.create(
        model="whisper-1",
        file=audio_file
    )

print(response.text)

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

Konuşma Oluştur

Önceki

Çeviri Oluştur

Sonraki