SupaStore

实时语音 (Realtime)

基于 WebSocket 的双向音视频低延迟交互接口,兼容 gpt-4o-realtime。

更新时间:

SupaStore 支持低延迟、双向音频流实时通话接口。该接口兼容 OpenAI Realtime API 标准,适用于开发实时语音助理或音视频即时交互应用。


📡 WebSocket 连接配置

与普通 HTTP 接口不同,实时语音接口需要使用加密 WebSocket 协议进行连接:

wss://api.supastore.cc/v1/realtime?model=gpt-4o-realtime

🔑 连接握手 Headers

在建立 WebSocket 连接建立阶段,您需要附带以下 HTTP 报头进行验证:

标头名 必填 示例/描述
Authorization 是 Bearer sk-xxxxxx(您的 API 密钥)
OpenAI-Beta 是 realtime=v1

🚀 会话事件交互简述

连接成功后,客户端与服务器通过 JSON 文本格式或二进制音频帧进行持续的双向事件传输。

1. 客户端发送事件 (Client Events)

  • session.update: 更改会话配置参数(如输入输出语音格式、首选发音人)。
  • input_audio_buffer.append: 向网关追加输入用户的 PCM 音频原始流数据。
  • response.create: 强制让模型根据当前输入缓冲区数据生成回答。

2. 服务端返回事件 (Server Events)

  • session.created: 会话连接建立成功通知。
  • response.audio.delta: 服务器返回的流式实时音频帧切片。
  • response.audio_transcript.delta: 服务器返回的流式实时回复文字转录切片。

详细协议帧定义及音频编解码配置(如 24kHz Mono 16-bit PCM 或 G.711 μ-law),请参考官方 SDK 实现文档。