4Z API

建立实时语音会话(WebSocket)

接口: WS https://4zapi.com/v1/realtime

这是 WebSocket 握手请求。协议请用 wss://,握手成功返回 101,之后双方用 JSON 文本消息通信。

鉴权二选一:

  • 能设置请求头的客户端(Apifox、Python、Node 等):Authorization: Bearer sk-xxx,子协议留空。
  • 浏览器:不能给 WebSocket 设置请求头,把密钥放进子协议: new WebSocket(url, ["realtime", "openai-insecure-api-key.sk-xxx", "openai-beta.realtime-v1"])。 密钥会出现在握手信息里,不要写进公开网页。

客户端事件(数据模型中以「客户端」开头):session.update、input_audio_buffer.append、 input_image_buffer.append、input_audio_buffer.commit、input_audio_buffer.clear、response.create、 response.cancel、conversation.item.create。

常用服务端事件(数据模型中以「服务端」开头):session.created、session.updated、 input_audio_buffer.speech_started、input_audio_buffer.speech_stopped、input_audio_buffer.committed、 input_audio_buffer.cleared、response.created、response.text.delta、response.text.done、 response.audio_transcript.delta、response.audio_transcript.done、response.audio.delta、 response.audio.done、response.function_call_arguments.done、 conversation.item.input_audio_transcription.completed、response.done、error。 另有 conversation.item.created、response.output_item.added 等过程事件,可忽略。

参数

  • model (query, string, 必填): 模型名,固定为 qwen3.8-omni-flash-realtime ["qwen3.8-omni-flash-realtime"]
  • Authorization (header, string): Bearer sk-xxx。浏览器调用时改用子协议传密钥,见接口说明
  • Sec-WebSocket-Protocol (header, string): 仅浏览器需要。格式:realtime, openai-insecure-api-key.sk-xxx, openai-beta.realtime-v1。 用 Authorization 请求头时不要填