Skip to main content

Resumen

Este endpoint sirve para reconocimiento de voz, síntesis de voz, traducción de voz o modelos multimodales en tiempo real. Un GET 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 con GET /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 pasa model 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.