Resumen
Este endpoint sirve para reconocimiento de voz, síntesis de voz, traducción de voz o modelos multimodales en tiempo real. UnGET normal devuelve metadatos; el upgrade WebSocket se proxifica a la sesión upstream enrutada.
Superficie admitida
Este endpoint es el proxy WebSocket en tiempo real de TokenLab. Admite una comprobación de metadatos conGET /v1/realtime y upgrades WebSocket en la misma ruta. No expone endpoints auxiliares REST de OpenAI Realtime como POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) ni creación de legacy beta REST session / transcription-session.
En apps web o móviles, mantén las claves API de larga duración en tu servidor. Este endpoint no emite Realtime client secrets de corta duración.
Los agentes deben descubrir modelos con soporte realtime en
/v1/models antes de abrir el socket.Conexión
string
requerido
ID del modelo en tiempo real. Usa un modelo cuyos detalles indiquen compatibilidad en tiempo real.
string
requerido
Clave API Bearer. Los clientes WebSocket deben enviar
Authorization: Bearer sk-your-api-key durante el upgrade.Mensajes
TokenLab reenvía mensajes WebSocket entre tu cliente y el proveedor realtime enrutado. Conserva la forma oficial de eventos del modelo elegido y pasamodel en la query string.
Facturación y cierre
Las sesiones realtime usan el mismo saldo de la clave API. TokenLab predescuenta una pequeña estimación al abrir y liquida o reembolsa al cerrar. Cierra el socket del cliente cuando termine la sesión. Si el upstream cierra primero, TokenLab reenvía el código de cierre cuando sea posible.Ejemplo de respuesta
Campos importantes
string
Tipo de evento o mensaje devuelto por la API.
string
Identificador emitido por el proveedor realtime; inclúyelo en logs de soporte, no como URL de sesión REST.