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 uç nokta, girdi dilinden bağımsız olarak her zaman İngilizce metin çıktısı verir.

Bu uç nokta sesi İngilizceye çevirir. language parametresini göndermeyin; ses çevirisi için desteklenmez ve unsupported_parameter hatası döndürebilir. Metin çevirisi için POST /v1/translations uç noktasını kullanın; recommended_for=translation ifadesi bu metin API'sine atıfta bulunur.

İstek Gövdesi

Çeviri, işleme tamamlandığında döner. Daha uzun ses dosyaları için en az 120s HTTP istemci zaman aşımı (timeout) süresine izin verin.

filefilezorunlu

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

modelstringzorunlu

Şu anda hiçbir genel model POST /v1/audio/translations için destek bildirmemektedir; varsayılan veya kopyalanabilir bir model ID'si bulunmamaktadır.

promptstring

Modelin üslubunu 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ı formatı. Kabul edilen değerler modele bağlıdır; modelin ayrıntılarını kontrol edin. text, bir JSON nesnesi yerine ham metin döndürür.

temperaturenumber

Yalnızca bu parametreyi listeleyen modeller için 0 ile 1 arasında örnekleme sıcaklığı (temperature).

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ı formatına 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ıtta bildirilen dil etiketi.

durationnumber

Girdi sesinin saniye cinsinden süresi.

segmentsarray

Çevrilen metnin zaman damgalı segmentleri.

İstek

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

Yanıt

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

Çeviri ve Transkripsiyon Karşılaştırması

ÖzellikÇeviriTranskripsiyon
Çıktı diliHer zaman İngilizceGirdi ile aynı
Kullanım senaryosuYabancı 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