확장 실시간 스트리밍 (/v1/realtimeext)

/v1/realtimeext는 세션 메타데이터, 동적 엔드포인트 임계값 및 세부 VAD 상태 이벤트가 필요한 고급 애플리케이션(DuRT 등)을 위해 설계된 OneASR의 확장 WebSocket 프로토콜입니다.

---

연결 엔드포인트

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

---

URL Query 매개변수

매개변수	타입	기본값	설명
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": "Live meeting transcription",
  "start": 12.45,
  "end": 14.20
}

3. 최종 확정 문장 (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 }
  ]
}