Skip to main content

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. Normal GET 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 normal GET /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 ve model 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.