跳到文档内容
瑞云智能
开发文档
API 参考Realtime

Realtime

在网关 WebSocket 与上游短期凭据两种接入方式之间选择。

WS/v1/realtime?model=:modelscope · chat 或 realtime

网关 WebSocket#

HTTP
wss://your-gateway-host/v1/realtime?model=your-public-model
Authorization: Bearer sk_your_gateway_key

网关验证密钥、选择模型与上游账号,并桥接双向消息。服务端客户端可通过 Authorization 请求头鉴权;浏览器协议支持 openai-insecure-api-key.<KEY> 子协议。URL 查询参数不能携带密钥。公开页面应避免向不可信客户端分发长期服务密钥。

网关连接执行请求/并发门禁,计费配置可按时长结算,并记录可识别的上游 Token 用量。Token 限额密钥、订阅账户和订阅 OAuth 上游账号不能使用此方式;连接中断不会自动跨账号重连。

直连上游短期凭据#

cURL
curl "https://www.ackddos.store/v1/realtime/client_secrets" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "session": {
    "type": "realtime",
    "model": "your-public-model"
  }
}'

此 HTTP 入口要求 chat 或 realtime scope 和支持原生 client secret 的上游。返回凭据和有效期取决于上游响应;读取 expires_at,不要写死十分钟。随后客户端按供应商协议直连上游,后续连接不经过网关。

配置访问限额的密钥无法使用直连短期凭据,因为后续流量会绕过网关限额。套餐不包含 Realtime;需要先取消订阅回到原有钱包计费规则。

搜索文档

推荐阅读

推荐阅读