查询对话状态
更新时间：2026-04-14
POST
https://qianfan.baidubce.com/v2/app/memory/conversations/status
根据对话 ID 批量获取指定对话的运行状态，返回每个对话的当前状态信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
conversation_ids
array
对话 ID 列表
必选
显示子属性
隐藏子属性
items
string
end_user_id
string
终端用户 ID，用于隔离不同用户的对话上下文和历史记录。
用户自定义上传，长度限制为 6～63 字符。
若未传入或传空时，系统将根据 API Key 对应的账号 ID 自动生成一个默认的终端用户 ID
可选
请求结构
POST /v2/app/memory/conversations/status HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"conversation_ids": ["1f94aa6d-****-461d-a348-9bfabfb168a3"],
"end_user_id": "test001"
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/app/memory/conversations/status" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"conversation_ids": ["1f94aa6d-****-461d-a348-9bfabfb168a3"]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码
可选
message
string
响应信息
可选
request_id
string
请求 ID
可选
result
object {1}
返回结果对象
可选
显示子属性
隐藏子属性
data
array
状态信息列表
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
conversation_id
string
对话 ID
可选
status
string
对话状态
可选
成功示例
{
"code": "success",
"message": "",
"request_id": "209d625f-61ad-****-b1d7-86a895ceedef",
"result": {
"data": [
{
"conversation_id": "7fe35901-****-40e8-9e78-2c5dff147cb1",
"status": "running"
}
]
}
}评价此篇文章