Erweitertes Echtzeit-Streaming (/v1/realtimeext)

/v1/realtimeext ist das erweiterte WebSocket-Protokoll von OneASR für anspruchsvolle Anwendungen (wie DuRT), die Sitzungsmetadaten, dynamische Endpunktschwellenwerte und detaillierte VAD-Zustandsereignisse erfordern.

---

Verbindungsendpunkt

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

---

URL-Abfrageparameter

Parameter	Typ	Standard	Beschreibung
api_key	string	Erforderlich	OneASR-Autorisierungsschlüssel.
model	string	xasr	Ziel-Streaming-Engine.
chunk_size	int	160	Internes Modell-Chunk-Fenster in Millisekunden.
vad_threshold	float	0.5	VAD-Sprachvertrauensschwellenwert (0.0 bis 1.0).

---

Ereignis-Nachrichtenablauf

1. Sprachstart-Ereignis (vad_speech_start)

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

2. Vorläufige Zwischenergebnisse (partial)

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

3. Finales Satzergebnis (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 }
  ]
}