Extended Realtime Streaming (/v1/realtimeext)

/v1/realtimeext is OneASR’s extended WebSocket protocol designed for advanced applications (such as DuRT) requiring session metadata, dynamic endpoint thresholds, and granular VAD state events.

---

Connection Endpoint

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

---

Query Parameters

Parameter	Type	Default	Description
api_key	string	Required	OneASR authorization key.
model	string	xasr	Target streaming engine.
chunk_size	int	160	Internal model chunk window in milliseconds.
vad_threshold	float	0.5	VAD speech confidence cutoff (0.0 to 1.0).

---

Event Message Flow

1. Speech Started Event (vad_speech_start)

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

2. Interim Partial Tokens (partial)

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

3. Sentence Final Token (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 }
  ]
}