超出任一限制将返回 413 Payload Too Large 或 422 Validation Error—— 参见 §05 错误码。

Exceeding any limit returns 413 Payload Too Large or 422 Validation Error — see §05 Error Codes.

说明：其他格式组合会被拒绝并立刻关闭（close code 1008）。 浏览器端可直接用 AudioContext({ sampleRate: 16000 })，由浏览器自动重采样到 16 kHz。

Any other format combination is rejected with an immediate close (close code 1008). Browsers can just use AudioContext({ sampleRate: 16000 }) and let the browser resample.

点击话筒开始录音；每说完一句话，右侧就会实时多出一段结果。再次点击话筒或发送 close 触发最终结果。需要上传文件请看 说话人日志 · 文件。

Click the mic to start recording; after each utterance ends, a new segment appears on the right. Click the mic again or send close to finalize. For file uploads, see Speaker Diarization · File.

先看下方消息序列 + 字段定义，再切到最下方语言 tab 复制可直接运行的代码片段。 不需要实时请看 说话人日志 · 文件模式。

Start by reading the message sequence and field definitions below, then scroll to the language tabs for copy-paste-ready snippets. Don't need real-time? See Speaker Diarization · File mode.

WebSocket 握手 → 发 start JSON → 持续推 PCM 二进制帧（200 ms/帧推荐）→ 每句 VAD 闭合收到 partial_result → 发 close 得到 final_result 结束。

WebSocket handshake → send a start JSON → stream PCM binary frames (200 ms recommended) → receive partial_result per closed utterance → send close to get a final_result and end.

请求字段

Request fields

消息序列

Message sequence

响应样本

Response sample

// 每完成一句话推一次；segments 是当前会话的完整快照，不是增量
{
  "type": "partial_result",
  "session_id": "6261ae2e072449438ee3d06f8e822ba1",
  "data": {
    "segments": [
      { "start_time": 0.0, "end_time": 4.81, "speaker_id": 0, "text": "" }
    ]
  },
  "stats": {
    "utterances": 1,
    "chunks": 6,
    "pipeline_ms": 29.5
  }
}

代码示例

Code snippets