Aperçu
Utilisez ce point de terminaison pour les sessions en temps réel telles que la reconnaissance vocale en streaming, la synthèse vocale, la traduction vocale ou les modèles multimodaux en temps réel. Une requêteGET standard renvoie les métadonnées du point de terminaison, tandis qu’une requête de mise à niveau WebSocket ouvre une session en temps réel pour le modèle sélectionné.
Surface prise en charge
TokenLab expose un endpoint WebSocket temps réel surGET /v1/realtime pour les contrôles de métadonnées et les upgrades WebSocket. Considérez-le comme un WebSocket subset : il relaie les événements des modèles realtime pris en charge et ne prend pas en charge les surfaces d’aide REST OpenAI Realtime comme la création de session, client_secrets, les API de contrôle d’appel Calls ou les legacy beta session APIs.
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 modèle en temps réel sélectionné. Utilisez le format d’événement décrit dans la documentation de ce modèle et incluezmodel dans la chaîne de requête plutôt que dans chaque événement.
Facturation et fermeture
Les sessions sont facturées sur le solde de votre clé API : TokenLab réserve une estimation au début, puis règle l’utilisation réelle à la fin et rembourse la différence. Fermez le socket client lorsque la session est terminée. Si le service ferme la session en premier, TokenLab transmet, dans la mesure du possible, un événement/code de fermeture sécurisé à votre client.Exemple de réponse
Champs importants
string
Type d’événement ou de message retourné par l’API.
string
Identifiant opaque reçu via la connexion realtime. Incluez-le dans les logs de support pour le diagnostic ; ce n’est pas une URL de session REST.