玄枢API

流式与 WebSocket

SSE 流式响应、Responses WebSocket 与断线处理。

最后验证日期: 2026-07-23

连接与鉴权

统一 OpenAI 兼容 Base URL: https://www.xuanshuapi.com/v1

OpenAI 兼容接口使用 Authorization: Bearer <YOUR_API_KEY>；Claude Messages 也支持 x-api-key: <YOUR_API_KEY>；Gemini v1beta 使用 x-goog-api-key: <YOUR_API_KEY>。

流式与 WebSocket

Messages、Responses、Chat Completions 和部分 Gemini action 支持流式；客户端应处理增量事件、超时与中断。

具体模型与高级能力以当前控制台配置为准。

请求体与调用

先用 SSE 验证流式请求；Responses WebSocket 需要正确 upgrade 并处理连接生命周期。

curl -N https://www.xuanshuapi.com/v1/chat/completions \
  -H "Authorization: Bearer <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","messages":[{"role":"user","content":"Count to three"}],"stream":true}'

响应与流式行为

SSE 按 data 行返回增量并以协议结束事件终止；客户端必须容忍空增量与中断。

HTTP 200
data: {"choices":[{"delta":{"content":"1"}}]}
data: {"choices":[{"delta":{"content":" 2"}}]}
data: [DONE]

关键参数

参数	说明
model	必须支持所选流式协议。
stream	设为 true。
timeout	客户端连接与读取超时。

典型故障

401/403 在握手前修复鉴权；426 检查 WebSocket upgrade；中断后重试要防止重复输出与费用。

HTTP 401/403  # authentication before streaming
HTTP 426  # invalid WebSocket upgrade
HTTP 429/5xx  # bounded reconnect candidate

下一步

可用模型、倍率、配额及部分高级能力动态依赖当前 Key 与控制台配置。