API 参考
实时
暂时没有可用模型
目前模型目录里没有模型支持这个接口,本页仅供参考。
WS
/v1/realtime当文本和音频需要在一条持久连接中传输时,使用 Realtime 端点。它与 HTTP API 使用同一套 API 密钥、密钥权限、模型权限和限流规则。
#从服务端建立连接
请从可信的服务端进程建立 WebSocket,并在握手时通过 Authorization: Bearer 发送 API 密钥。不要把长期 API 密钥放进浏览器 JavaScript:浏览器无法安全附带该请求头,任何人都能从已发布代码中提取密钥。
server.ts
import WebSocket from "ws";
const socket = new WebSocket("wss://YOUR_DOMAIN/v1/realtime", {
headers: { Authorization: "Bearer sk-YOUR_KEY" },
});
socket.on("open", () => {
// Send standard Realtime session and conversation events here.
});
socket.on("message", (event) => {
// Forward text / audio deltas to your client.
});#会话与事件流
连接后,按所选模型的标准 Realtime 格式发送会话和对话事件。通过你自己的短期通道把服务端事件转给浏览器,从而始终由你控制平台密钥和上游 WebSocket。
1
连接
建立一条经过认证的服务端连接。
2
配置
发送会话配置和对话输入。
3
转发
将增量事件转发给客户端,并在完成后关闭会话。
#有策略地重连
WebSocket 是有状态的。连接关闭后,请创建新会话,并且只重放应用明确保留的状态。将 401、403、402 和 429 视为需要处理的账户或密钥信号;对短暂网络错误和 5xx 错误进行有次数上限的退避重试。
不需要实时音频时,先使用 HTTP
普通流式文本使用 /v1/chat/completions 更易部署,并采用 SSE。只有当持久、低延迟会话成为产品体验的一部分时,再迁移到 Realtime。
还是没解决?
把请求 ID 或报错信息发给我们,我们来查。