概览
这个端点用于实时语音识别、语音合成、语音翻译或实时多模态模型等会话。普通GET 请求会返回端点元信息;WebSocket 升级请求会代理到路由后的实时上游会话。
支持范围
这个端点是 TokenLab 的实时 WebSocket 代理。它支持普通GET /v1/realtime 元信息检查,也支持在同一路径上发起 WebSocket 升级。它不提供 OpenAI Realtime 的 REST 辅助端点,例如 POST /v1/realtime/client_secrets、POST /v1/realtime/translations/client_secrets、Realtime Calls(accept、hangup、refer、reject),也不提供 legacy beta REST session / transcription-session 创建。
浏览器或移动端应用应把长期 API Key 保留在服务端。这个端点不会签发短期 Realtime client secret。
Agent 应先通过
/v1/models 发现支持 realtime 的模型,再打开 socket。连接
string
必填
实时模型 ID。请选择模型说明中包含 realtime 支持的模型。
string
必填
Bearer API Key。WebSocket 客户端应在升级请求中发送
Authorization: Bearer sk-your-api-key。消息
TokenLab 会在客户端和路由后的实时提供方之间转发 WebSocket 消息。请保留所选模型的官方事件结构,并通过查询参数传入model。
计费与关闭
实时会话使用同一 API Key 余额。TokenLab 会在 socket 打开时预扣小额估算费用,并在会话关闭时结算或退款。 会话完成后关闭客户端 socket。如果上游先关闭,TokenLab 会尽可能把关闭码转发给客户端。响应示例
重要字段
string
API 返回的事件或消息类型。
string
实时提供方返回的标识符;可用于日志和支持排障,不是 REST session URL。