开发者指南 · 10

实时语音(S2S WebSocket)

10.1 模块

app/voice/router.py 提供 WebSocket 端点 /api/voice/ws,作为 OpenAI Realtime API 的代理。

10.2 工作流

text
浏览器 ──WebSocket──→ FastAPI ──WebSocket──→ wss://api.openai.com/v1/realtime

                       └── session.update 时注入工具配置
                       └── 工具调用透传 + 后端工具执行
  • 工具注入:session.update 事件中包含 Admin 配置的工具集
  • 鉴权:通过 query 参数携带 JWT
  • API Key:通过 S2S_API_KEY / S2S_BASE_URL 覆盖(fallback 到 OPENAI_API_KEY