Medya kılavuzları
Ses ve gerçek zamanlı işlemler
Ses oluşturun, sesi metne dönüştürün, konuşmayı çevirin veya gerçek zamanlı bir oturum başlatın
Sonucun bir dosya veya metin olduğu durumlarda ses uç noktalarını kullanın. Canlı, çift yönlü bir ses deneyimi için gerçek zamanlı WebSocket uç noktasını kullanın.
Bir uç nokta seçin
| İhtiyaç | Uç Nokta | Kullanım Durumu |
|---|---|---|
| Metinden sese | POST /v1/audio/speech | Metinden bir ses dosyasına ihtiyacınız olduğunda. |
| Transkripsiyon | POST /v1/audio/transcriptions | Bir ses dosyasından metne ihtiyacınız olduğunda. |
| Ses çevirisi | POST /v1/audio/translations | Bir ses dosyasından çevrilmiş metne ihtiyacınız olduğunda. |
| Gerçek zamanlı WebSocket | WS /v1/realtime?model={model} | WebSocket üzerinden çift yönlü ses akışına ihtiyacınız olduğunda. Sade GET /v1/realtime yalnızca meta veri döndürür. |
Bir model seçin
Mevcut model listesini sabit kodlamak (hard-coding) yerine okuyun. Bir soket açmadan önce seçilen modelin ayrıntılarını gerçek zamanlı destek açısından kontrol edin.
curl "https://api.tokenlab.sh/v1/models?recommended_for=tts" \
-H "Authorization: Bearer sk-your-api-key"
curl "https://api.tokenlab.sh/v1/models?recommended_for=stt" \
-H "Authorization: Bearer sk-your-api-key"Ses istekleri
Speech (Konuşma), HTTP yanıtında ses döndürür. Transkripsiyon ve çeviri, nihai metni veya kabul edilmiş bir görevi döndürebilir. Gövde, nihai metin yerine bir görev kimliği (task ID) ve durum içerdiğinde, kimliği kaydedin ve tamamlanana veya başarısız olana kadar GET /v1/tasks/{id} uç noktasını sorgulayın (poll). Büyük dosyalar için yeterli zaman tanıyın ve Request ID'yi saklayın.
Ses sonucu URL'leri, 30 gün boyunca geçerli kalan TokenLab medya sonucu URL'leridir. media_retention.items, her öğenin kaydetme durumunu ve expires_at bilgisini raporlar; kaydetme durumu zamanında bilinmediğinde yanıt media_retention bilgisini içermeyebilir ancak URL yine de çalışır. Satır içi veya ikili (binary) ses yanıtları bu URL kopyalama saklama kapsamının dışındadır. Bkz: Veri saklama.
curl -X POST "https://api.tokenlab.sh/v1/audio/speech" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-tts",
"voice": "eve",
"input": "Welcome to TokenLab."
}' \
--output speech.mp3Gerçek zamanlı oturumlar
Sorgu dizesinde model ve Authorization başlığında API anahtarı ile bir WebSocket açın. Seçilen gerçek zamanlı model için belgelenmiş olay formatını koruyun ve oturum tamamlandığında soketi kapatın.
Bir oturum en fazla 1 saat sürer. Ardından sunucu, 1000 kodu ve session_timeout nedeni ile soketi kapatır. Tek bir mesaj 32 MiB'a kadar olabilir; daha büyük bir mesaj soketi 1009 kodu ile kapatır. grok-voice-think-fast-2.0 gibi bazı gerçek zamanlı modeller yalnızca ses karelerini ve oturum güncellemelerini kabul eder. Metin girişi öğesi unsupported_realtime_text_input hatasını döndürür ve soketi 1008 kodu ile kapatır.
Bu kılavuz yalnızca WebSocket alt kümesini kapsar. TokenLab şu anda OpenAI Realtime REST istemci sırrı, çeviri istemci sırrı, Çağrılar veya eski beta oturum yönetimi uç noktaları sağlamamaktadır.
Aşağıdaki sunucu tarafı örneği için ws paketini yükleyin ve TOKENLAB_REALTIME_MODEL değişkenini, ayrıntılarında /v1/realtime bildiren güncel bir modele ayarlayın. Sunucu ortamında TOKENLAB_API_KEY sağlayın; yalnızca ismin varlığı gerçek zamanlı desteği oluşturmaz.
npm install wsimport WebSocket from 'ws';
const model = process.env.TOKENLAB_REALTIME_MODEL;
const apiKey = process.env.TOKENLAB_API_KEY;
if (!model || !apiKey) throw new Error('Set TOKENLAB_REALTIME_MODEL and TOKENLAB_API_KEY');
const url = new URL('wss://api.tokenlab.sh/v1/realtime');
url.searchParams.set('model', model);
const socket = new WebSocket(url, {
headers: { Authorization: `Bearer ${apiKey}` },
});
socket.on('message', (event) => console.log(event.toString()));
socket.on('error', (error) => console.error(error.message));
process.once('SIGINT', () => socket.close(1000, 'Client stopped'));İlerlemeyi güvenli bir şekilde gösterin
- Yenileme sırasında aynı isteği tekrar oynatmak yerine oluşturulan ses dosyalarını kaydedin.
- Transkripsiyon ve çeviri için, API çağrısı senkron olsa bile yükleme ve işleme durumlarını gösterin.
- Gerçek zamanlı işlemler için, kapatma olaylarını yönetin ve yalnızca kullanıcı yeni bir oturum başlattıktan sonra yeniden bağlanın.
- Ses metni girişine API anahtarları, özel URL'ler veya hesap sırları koymayın.
API Referansı
| Konu | Referans |
|---|---|
| Konuşma Oluşturma | Konuşma Oluşturma |
| Transkripsiyon Oluşturma | Transkripsiyon Oluşturma |
| Çeviri Oluşturma | Çeviri Oluşturma |
| Gerçek zamanlı WebSocket | Gerçek zamanlı WebSocket |
| Modelleri Listele | Modelleri Listele |
| Faturalandırma ve Fiyatlandırma | Faturalandırma ve Fiyatlandırma |