跳到主要内容

分叉 Live 会话

GET 

wss://api.knox.chat/v1/live/sessions/:session_id/fork

POST 

https://api.knox.chat/v1/live/sessions/:session_id/fork

把已存储的 Live 会话(创建时 store: true)分叉成继承历史的新对话。只有所有者可以分叉。分叉使用与源会话相同的上游 OpenAI 通道。

  • GET 升级为 WebSocket。第一条消息仍必须是 session.start。分叉可覆盖的字段仅限 store、Responses 委派和 audio.format。
  • POST 用 SDP offer 创建 WebRTC 分叉(JSON { "sdp", "session" } 或原始 application/sdp)。

继承的设置(音色、instructions、委派模式)除非你发送允许的覆盖,否则保持不变。不能更改 model;分叉仍使用 gpt-live-1。

见 GPT-Live 指南。

路径参数​

名称类型必填描述
session_idString是已存储源会话的 id。

WebSocket 分叉​

import WebSocket from "ws";

const sourceId = "sess_…";
const ws = new WebSocket(
`wss://api.knox.chat/v1/live/sessions/${sourceId}/fork`,
{ headers: { Authorization: "Bearer " + process.env.KNOX_API_KEY } }
);

ws.on("open", () => {
ws.send(JSON.stringify({
type: "session.start",
session: { store: true },
}));
});

非 WebSocket 的 GET 返回 400:请通过 WebSocket 连接 /v1/live/sessions/{id}/fork,或 POST 一个 WebRTC SDP offer。

WebRTC 分叉​

curl -s https://api.knox.chat/v1/live/sessions/sess_…/fork \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sdp": "v=0\r\n…",
"session": { "store": true }
}'

与 创建 相同的 15 秒 WebRTC 预收。

错误响应​

状态何时
400不是 WebSocket(GET)、缺少 SDP(POST),或分叉 session 无效。
401缺少或无效的 Knox API key。
402账户余额不大于 $0.01。
403Token 未被授权使用 gpt-live-1。
404源会话不存在、未存储,或不属于当前用户。
502上游分叉失败。