查询Agent状态

查询指定房间内语音Agent的运行状态，用于了解当前会话是否活跃，便于进行异常处理和资源管理。

GET /v1/realtime/status

查询 Agent 状态

cURL

curl --request GET \
  --url https://api.senseaudio.cn/v1/realtime/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'

200

Example

{
  "status": "RUNNING"
}

授权

Authorization · string · header · 必填

格式：Bearer <API_KEY>

请求头

Content-Type · string · 默认值: application/json · 必填

内容类型。固定为 application/json

示例:

"application/json"

查询参数

room_id · string · 默认值: lO81loRAfmUMFIwY · 必填

房间 ID，从「创建对话式 Agent」接口返回值中获取

示例:

"lO81loRAfmUMFIwY"

响应

200

application/json

成功响应

status · enum<string> · 必填

Agent 状态。RUNNING: 运行中；STOPPED: 已停止

可用选项: RUNNING, STOPPED

示例:

"RUNNING"