Skip to content

標準即時串流辨識 (/v1/realtime) ​

/v1/realtime 端點提供了標準的全雙工 WebSocket 音訊推流與即時字幕返回能力。


連線端點 ​

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

音訊輸入規格 ​

  • 取樣率:16,000 Hz (16 kHz)
  • 聲道數:1 (單聲道 Mono)
  • 編碼格式:帶符號 16 位元 PCM Little-Endian (pcm_s16le)
  • 建議分包時長:每訊框 100ms ~ 200ms(約 3,200 位元組)

通訊協定範例 ​

用戶端傳送: ​

持續向 WebSocket 連線傳送原始 PCM 二進位音訊位元組串流。

伺服端回傳(JSON 格式): ​

json
{
  "type": "transcription",
  "text": "歡迎使用",
  "is_final": false,
  "start": 0.0,
  "end": 1.2
}

當檢測到語音靜音斷句時:

json
{
  "type": "transcription",
  "text": "歡迎使用 OneASR 語音閘道。",
  "is_final": true,
  "start": 0.0,
  "end": 1.8
}