擴充串流控制協定 (/v1/realtimeext)

/v1/realtimeext 是 OneASR 專為進階用戶端（如 DuRT 浮動字幕）設計的擴充串流介面，支援動態斷句參數設定與精準的 VAD 語音生命週期事件。

---

連線端點

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

---

連線參數說明

參數名	類型	預設值	參數描述
api_key	string	必填	OneASR 服務鑑權憑證。
model	string	xasr	指定的串流推論引擎。
chunk_size	int	160	模型處理分塊視窗 (毫秒)。
vad_threshold	float	0.5	VAD 語音檢測信賴度閾值 (0.0 ~ 1.0)。

---

核心事件返回格式

1. 語音起始事件 (vad_speech_start)

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

2. 中間識別結果 (partial)

{
  "event": "partial",
  "text": "即時會議字幕轉錄",
  "start": 12.45,
  "end": 14.20
}

3. 整句完成終態 (final)

{
  "event": "final",
  "text": "即時會議字幕轉錄進行中。",
  "start": 12.45,
  "end": 15.00,
  "words": [
    { "word": "即時", "start": 12.45, "end": 12.80 },
    { "word": "會議", "start": 12.85, "end": 13.40 }
  ]
}