扩展流式控制协议 (/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 }
  ]
}