Live SIP 呼叫控制
已有 Live 会话上的 SIP 辅助接口。外呼请用 POST /v1/live/sessions。挂 sideband 观察振铃和接通。见 GPT-Live 指南和 OpenAI Telephony。
四条路由都需要 Authorization: Bearer sk-… 和路径参数 session_id。相同路由也挂载在 /api/v1 下。
接听
POSThttps://api.knox.chat/v1/live/sessions/:session_id/accept
接听来电 SIP。Knox 把 session.model 固定为 gpt-live-1,并把 session.type 设为 "live"(OpenAI 要求;不要发送其他值)。开始计费,预收 15 秒 SIP 费用。
curl -s https://api.knox.chat/v1/live/sessions/sess_…/accept \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session": {
"model": "gpt-live-1",
"audio": { "output": { "voice": "marin" } },
"store": true
}
}'
空请求体可接受。若存在 session.type,必须为 "live"。
挂断
POSThttps://api.knox.chat/v1/live/sessions/:session_id/hangup
结束 SIP 呼叫。无请求体。
curl -s https://api.knox.chat/v1/live/sessions/sess_…/hangup \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-X POST
转接(Refer)
POSThttps://api.knox.chat/v1/live/sessions/:session_id/refer
转接呼叫。target_uri 必填,必须是不含空白的 SIP Refer-To URI。
curl -s https://api.knox.chat/v1/live/sessions/sess_…/refer \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "target_uri": "sip:+15555550199@sip.example.com" }'
拒接
POSThttps://api.knox.chat/v1/live/sessions/:session_id/reject
拒接来电 SIP。status_code 必填,必须是 300-699 的整数。
curl -s https://api.knox.chat/v1/live/sessions/sess_…/reject \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status_code": 486 }'
错误响应
| 状态 | 何时 |
|---|---|
400 | JSON 无效、session.type 不是 "live"(接听)、缺少 target_uri(转接),或 status_code 不在 300-699(拒接)。 |
401 | 缺少或无效的 Knox API key。 |
402 | 账户余额不大于 $0.01(接听会开始计费会话)。 |
403 | Token 未被授权使用 gpt-live-1。 |
404 | 会话不存在或不属于你。 |
502 | 上游 SIP 操作失败。 |