Aperçu
Cet endpoint sert aux sessions de reconnaissance vocale, synthèse vocale, traduction vocale ou modèles multimodaux en temps réel. UnGET classique renvoie les métadonnées; une requête WebSocket est proxifiée vers la session upstream routée.
Surface prise en charge
Cet endpoint est le proxy WebSocket temps réel de TokenLab. Il prend en charge un contrôle de métadonnéesGET /v1/realtime classique et les upgrades WebSocket sur le même chemin. Il n’expose pas les endpoints REST auxiliaires OpenAI Realtime, comme POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) ni la création legacy beta REST session / transcription-session.
Pour les apps navigateur ou mobile, conservez les clés API longue durée côté serveur. Cet endpoint n’émet pas de Realtime client secrets de courte durée.
Les agents doivent découvrir les modèles compatibles realtime avec
/v1/models avant d’ouvrir le socket.Connexion
string
requis
ID du modèle temps réel. Utilisez un modèle dont le détails du modèle indique la prise en charge realtime.
string
requis
Clé API Bearer. Les clients WebSocket doivent envoyer
Authorization: Bearer sk-your-api-key pendant la requête d’upgrade.Messages
TokenLab relaie les messages WebSocket entre votre client et le fournisseur temps réel routé. Conservez les formes d’événements officielles du modèle choisi et passezmodel dans la query string.
Facturation et fermeture
Les sessions realtime utilisent le même solde de clé API. TokenLab pré-déduit une petite estimation à l’ouverture, puis règle ou rembourse à la fermeture. Fermez le socket client quand la session est terminée. Si l’upstream ferme d’abord, TokenLab relaie le code de fermeture lorsque c’est possible.Exemple de réponse
Champs importants
string
Type d’événement ou de message retourné par l’API.
string
Identifiant émis par le fournisseur temps réel ; incluez-le dans les logs de support, pas comme URL de session REST.