这些端点由 Happy Voice 网关提供服务（非主 Happy 服务端）。需要在请求头中携带 X-Voice-Key 或使用语音公钥的 Authorization: Bearer。

​
开始会话

POST /v1/voice/session/start
创建新的语音会话。 请求体：
字段类型说明
userIdstring用户标识符
sessionIdstring关联的应用会话 ID
languagestring语言代码（例如 en、zh）
initialContextPayloadobject语音代理的初始上下文
toolBridgeBaseUrlstring用于工具调用的 Happy Server URL
welcomeMessagestring可选的自定义欢迎语
响应： 
{
  "allowed": true,
  "gatewaySessionId": "uuid",
  "roomName": "happy_voice_...",
  "roomUrl": "wss://livekit.example.com",
  "participantIdentity": "human_...",
  "participantToken": "jwt-token...",
  "expiresAt": "2026-03-26T01:00:00.000Z"
}

​
停止会话

POST /v1/voice/session/stop
停止语音会话并清理房间。 请求体：
字段类型说明
gatewaySessionIdstring开始会话响应中的会话 ID

​
获取会话状态

GET /v1/voice/session/:gatewaySessionId/status
查询语音会话的当前状态。

​
发送文本

POST /v1/voice/session/text
向语音会话中注入文本消息。 请求体：
字段类型说明
gatewaySessionIdstring会话 ID
textstring要注入的文本

​
发送上下文

POST /v1/voice/session/context
向语音代理发送应用上下文。 请求体：
字段类型说明
gatewaySessionIdstring会话 ID
payloadobject上下文载荷（会话状态、消息等）