TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Ses ve gerçek zamanlı

Çeviri Oluştur

Sesi İngilizce metne çevirir

POST
/v1/audio/translations

Genel Bakış

Desteklenen herhangi bir dildeki sesi İngilizce metne çevirir. Transkripsiyondan farklı olarak, bu endpoint girdi dilinden bağımsız olarak her zaman İngilizce metin çıktısı üretir.

Bu endpoint sesi İngilizceye çevirir. language göndermeyin; ses çevirisi bu parametreyi desteklemez ve unsupported_parameter döndürebilir. Metin çevirisi için POST /v1/translations kullanın; recommended_for=translation bu metin API’sini belirtir.

İstek Gövdesi

Çeviri işlemi tamamlanınca yanıt döner. Uzun sesler için HTTP zaman aşımını en az 120s olarak ayarlayın.

filefilezorunlu

Çevrilecek ses dosyası. Desteklenen formatlar: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Maksimum dosya boyutu 25 MB'dir.

modelstringvarsayılan: whisper-1

Ses çevirisi model ID’si; örneğin whisper-1. Güncel model ayrıntılarında POST /v1/audio/translations desteğini doğrulayın.

promptstring

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

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.

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

İngilizceye çevrilmiş metin.

verbose_json formatı için, yanıt ayrıca şunları içerir:

languagestring

Sağlandığında yanıttaki dil etiketi.

durationnumber

Girdi sesinin saniye cinsinden süresi.

segmentsarray

Zaman damgalarıyla birlikte çevrilmiş metin segmentleri.

İstek

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@german_audio.mp3" \
  -F "model=whisper-1"

Yanıt

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Çeviri vs Transkripsiyon

ÖzellikÇeviriTranskripsiyon
Çıktı diliHer zaman İngilizceGirdi ile aynı
Kullanım durumuYabancı dildeki sesi İngilizceye dönüştürmeOrijinal dili koruma
Dil parametresiUygulanamazİsteğe bağlı ipucu

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

Transkripsiyon Oluştur

Önceki

Realtime WebSocket

Sonraki