拡張ストリーミング制御プロトコル (/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 }
  ]
}