Genel bakış
Bu endpoint gerçek zamanlı konuşma tanıma, konuşma sentezi, konuşma çevirisi veya çok modlu realtime modeller için kullanılır. NormalGET istekleri metadata döndürür; WebSocket upgrade istekleri yönlendirilen upstream oturumuna proxy edilir.
Desteklenen yüzey
Bu endpoint TokenLab’in gerçek zamanlı WebSocket proxy’sidir. Aynı path üzerinde normalGET /v1/realtime metadata kontrolünü ve WebSocket upgrade isteklerini destekler. POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) veya legacy beta REST session / transcription-session oluşturma gibi OpenAI Realtime REST yardımcı endpoint’lerini sunmaz.
Tarayıcı veya mobil uygulamalarda uzun ömürlü API anahtarlarını sunucunuzda tutun. Bu endpoint kısa ömürlü Realtime client secret üretmez.
Agent’lar socket açmadan önce
/v1/models ile realtime destekli modeli bulmalıdır.Bağlantı
string
gerekli
Gerçek zamanlı model ID’si. Genel sözleşmesinde realtime desteği bulunan bir model kullanın.
string
gerekli
Bearer API anahtarı. WebSocket istemcileri upgrade isteğinde
Authorization: Bearer sk-your-api-key göndermelidir.Mesajlar
TokenLab, istemciniz ile yönlendirilen realtime sağlayıcı arasında WebSocket mesajlarını aktarır. Seçilen modelin resmi event biçimlerini koruyun vemodel değerini query string içinde gönderin.
Ücretlendirme ve kapatma
Realtime oturumlar aynı API key bakiyesini kullanır. TokenLab socket açıldığında küçük bir tahmini tutarı önceden düşer, oturum kapanınca kesinleştirir veya iade eder. Oturum tamamlandığında client socket’i kapatın. Upstream önce kapatırsa TokenLab mümkün olduğunda close code’u iletir.Yanıt örneği
Önemli alanlar
string
API tarafından dönen event veya message type.
string
Gerçek zamanlı sağlayıcının döndürdüğü kimliktir; destek loglarında kullanın, REST session URL olarak değil.