开发者文档

完整的 API 文档,兼容 OpenAI 接口标准

WS/v1/realtime

实时语音

通过 WebSocket 连接实现实时音频流处理,支持实时语音识别和语音合成。

连接地址

wss://token.wlj.weifaner.net:8001/v1/realtime?model=gpt-4o-realtime-preview

连接参数

参数名类型必填说明
modelstring实时模型,如 gpt-4o-realtime-preview
AuthorizationstringBearer Token(通过 header 或 query 传递)

消息类型

类型方向说明
session.update客户端 → 服务端更新会话配置
input_audio_buffer.append客户端 → 服务端发送音频数据
response.create客户端 → 服务端创建响应
response.audio.delta服务端 → 客户端音频数据块
response.done服务端 → 客户端响应完成

使用示例

const ws = new WebSocket(
  'wss://token.wlj.weifaner.net:8001/v1/realtime?model=gpt-4o-realtime-preview',
  [],
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

ws.onopen = () => {
  // 更新会话配置
  ws.send(JSON.stringify({
    type: 'session.update',
    session: {
      modalities: ['text', 'audio'],
      voice: 'alloy'
    }
  }));
};

ws.onmessage = (event) => {
  const message = JSON.parse(event.data);
  console.log('Received:', message);
};

最后更新于 2026/5/25