標準即時串流辨識 (/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
}