GET /v1/realtime
握手与协议
连接占位 URLwss://gateway.example.com/v1/realtime?model=YOUR_MODEL_ID，用 WebSocket 客户端和 Bearer 网关令牌升级；model query 必填并由 URL 编码。请求无 JSON body，成功升级返回 HTTP 101；失败可能为 HTTP 4xx/5xx，升级后仍可能收到 error 或直接断开。
本站采用 GA 的 session 配置与 response.output_* 事件。OpenAI 适配器只对映射后名称含 -realtime-preview 的遗留模型附加上游 Beta 标识；这不代表自动转换事件结构。避免混合 Beta 的 modalities / input_audio_format / response.audio.delta 与本文 GA 字段。
客户端事件与字段
字段以 Realtime client events为协议依据，网关和模型可能不支持全部扩展。本站脚本关闭工具和 VAD，每次只生成一轮，下面展示文字模式的三条独立消息：
服务端事件与关联
内容事件使用 response_id、item_id、output_index、content_index 关联。最终 response.done 不含完整音频字节，要保留音频 delta。音频 done 也可能出现于非成功结束，必须继续核对最终状态。服务端事件参考给出完整上游结构。
音频格式与限制
示例请求 PCM16LE、24 kHz、单声道，配置为audio.input.format / audio.output.format 的 type: audio/pcm、rate: 24000；音色位于 audio.output.voice。turn_detection: null 关闭自动 VAD，示例检查有效配置后才发送内容。其他格式、声音与采样率需模型支持，不能直接按 PCM WAV 保存。
后端可以施加连接时限、流空闲时限及实时请求限制。断开不保证业务成功，也不保证请求未执行；应用应保留完成状态和已播放位置，不自动重发音频。浏览器临时密钥、WebRTC、SIP 与 Live API 不属于此路由的自动兼容范围。
相关源码：router/relay-router.go、relay/channel/openai/adaptor.go、relay/channel/openai/relay_realtime.go，核对版本 30a6d88a4。此页使用可迁移 Markdown 描述握手与事件，不伪装成普通 JSON REST 操作。
文字与音频可运行示例 · 连接模块
Read in English