標準リアルタイムストリーミング認識 (/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) - 推奨パケットサイズ/間隔:1フレームあたり 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
}