Streaming Extendido en Tiempo Real (/v1/realtimeext)

/v1/realtimeext es el protocolo WebSocket extendido de OneASR diseñado para aplicaciones avanzadas (como DuRT) que requieren metadatos de sesión, umbrales dinámicos de fin de oración y eventos detallados de estado VAD.

---

Endpoint de Conexión

ws://localhost:8000/v1/realtimeext?api_key=sk-oneasr-xxx&model=xasr&chunk_size=160&vad_threshold=0.5

---

Parámetros de Consulta URL

Parámetro	Tipo	Por Defecto	Descripción
api_key	string	Requerido	Clave de autorización de OneASR.
model	string	xasr	Motor de streaming de destino.
chunk_size	int	160	Ventana de fragmento interno del modelo en milisegundos.
vad_threshold	float	0.5	Umbral de confianza de voz VAD (0.0 a 1.0).

---

Flujo de Mensajes de Eventos

1. Evento de Inicio de Voz (vad_speech_start)

{
  "event": "vad_speech_start",
  "timestamp": 12.45
}

2. Tokens Parciales Intermedios (partial)

{
  "event": "partial",
  "text": "Live meeting transcription",
  "start": 12.45,
  "end": 14.20
}

3. Token Final de Oración (final)

{
  "event": "final",
  "text": "Live meeting transcription in progress.",
  "start": 12.45,
  "end": 15.00,
  "words": [
    { "word": "Live", "start": 12.45, "end": 12.80 },
    { "word": "meeting", "start": 12.85, "end": 13.40 }
  ]
}