文档

创建实时语音会话

实时语音会话的握手入口。它不是一次普通的 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": "<错误类型>"
  }
}

计费与用量

实时语音按会话时长从账户余额扣减,用量明细在控制台查看。