实时会话 realtime
/v1/realtime 是 WebSocket 入口,用于低延迟的双向语音/文本会话。
连接方式
wss://api.token.heimatianqi.com/v1/realtime?model=<模型名>
握手时带鉴权头:
Authorization: Bearer sk-heima-xxxxxxxx
连接建立后按官方 Realtime 协议发送/接收事件(JSON 帧)。
计费
- 实时会话按音频/文本 tokens计费,输入与输出分别计价;
- 会话断开时按实际已产生的用量结算(可在「使用日志」里核对);
- 实时会话通常比普通对话单价更高,务必设置
max_tokens/会话时长上限并在应用侧做超时保护。
注意
- 需要该模型与上游同时支持 Realtime;不支持时会明确拒绝。
- 长连接会被平台的渠道容量保护统计(在途连接计入并发),突发扩容前请先沟通容量。
常见问题
- 连不上:多数客户端需要显式允许
wss://,并确保握手头带上了 Key。 - 中途断开:检查网络与代理;断开会话仍按已产生的用量计费。