创建实时语音会话
实时语音会话的握手入口。它不是一次普通的 HTTP 调用,而是把连接升级成 WebSocket,之后音频与会话事件都在这条连接上收发。
GET https://open.feiyutoken.com/v1/realtime
连接方式
这是一个 WebSocket 端点:握手阶段走 HTTP GET,握手成功后连接升级为 WebSocket,
从那时起就不再是“发一次请求、收一次响应”,而是在同一条长连接上双向收发实时对话的音频与会话事件。
WebSocket 形式的地址与上面同一个路径,把协议换成 wss:
wss://open.feiyutoken.com/v1/realtime?model=<模型名>
- 用 WebSocket 客户端发起连接,不要用普通 HTTP 客户端。
- 连接建立后的事件名称、字段与交互顺序,按 OpenAI Realtime API 的事件格式实现。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 否 | 这次会话要用的模型,作为查询参数带上;可用值见模型列表 |
鉴权
握手时带上 API Key,方式与其他接口一致:
-H "Authorization: Bearer <你的飞鱼Token API Key>"
请求示例
握手要由 WebSocket 客户端发起:它会自己补齐 Sec-WebSocket-Key、Sec-WebSocket-Version
这些标准头,用普通 HTTP 客户端(包括 curl)拼不出合法的升级请求。鉴权用 Authorization: Bearer,
所以浏览器原生的 WebSocket 用不了(它没有设置请求头的接口),请从服务端或命令行客户端连。
响应
握手成功返回 101 Switching Protocols,连接从此升级为 WebSocket。
握手失败返回普通 JSON 错误,结构与本平台其它接口一致:
{
"error": {
"message": "<错误说明>",
"type": "<错误类型>"
}
}
计费与用量
实时语音按会话时长从账户余额扣减,用量明细在控制台查看。