실시간 스트리밍 (/v1/realtime)

/v1/realtime 엔드포인트는 라이브 자막 및 인터랙티브 음성 에이전트를 위한 표준 전이중(full-duplex) WebSocket 오디오 스트리밍을 제공합니다.

---

연결 엔드포인트

ws://localhost:8000/v1/realtime?api_key=sk-oneasr-v1-xxx&model=xasr

---

오디오 입력 형식

• 샘플 레이트: 16,000 Hz (16 kHz)
• 채널 수: 1 (모노)
• 인코딩: 16-bit Signed Integer PCM Little-Endian (pcm_s16le)
• 청크 길이: 프레임당 100ms ~ 200ms (청크당 3,200 바이트)

---

메시지 프로토콜

클라이언트 ➔ 서버:

WebSocket 연결을 통해 원시 바이너리 PCM 오디오 바이트를 지속적으로 스트리밍합니다.

서버 ➔ 클라이언트 (JSON 텍스트):

{
  "type": "transcription",
  "text": "Hello world",
  "is_final": false,
  "start": 0.0,
  "end": 1.2
}

문장 종결 경계가 감지된 경우:

{
  "type": "transcription",
  "text": "Hello world.",
  "is_final": true,
  "start": 0.0,
  "end": 1.8
}