Skip to content

保存用户回答 ​

把用户对当前追问的回答(自由文本或点击快捷选项的内容)持久化到会话消息历史,用于推进下一轮问诊。图片消息与供回放的模型消息也走同一接口。

请求地址 ​

POST
/v1/ms-ai-fast/session-records/messages

请求参数 ​

请求头 ​

请求头类型必填说明
Authorizationstring是访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。
Content-Typestring是请求体格式,固定为 application/json。

请求体 (Body):文本回答 ​

json
{
  "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
  "role": "user",
  "content": "最近没有更换食物。",
  "module_type": 1,
  "content_type": 1,
  "stage": 2
}

请求体 (Body):图片消息 ​

json
{
  "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
  "role": "user",
  "content": "用户补充了一张图片",
  "module_type": 1,
  "content_type": 2,
  "image": "<UPLOAD_RESPONSE_DATA_URL>"
}
参数名类型必填说明
session_idstring是会话唯一标识符。
rolestring是发言角色:user、assistant、system;其他值返回 400。
contentstring是消息文本;也接受 JSON 字符串。
module_typeinteger否1 智能问诊、5 图片识别;不传时按会话记录自动取值。
content_typeinteger否1 文本(默认)、2 图片、3 JSON。
stageinteger否业务阶段序号;问诊回答通常传 2。
parent_sessionstring/null否父会话 ID。
imagestring/null否图片消息的图片 URL;使用 /oss/images 返回的原样 url。
extra_jsonobject/null否扩展信息。
is_hiddeninteger否是否隐藏,默认 0。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "id": 2,
    "created_at": "2026-09-16T14:32:00+08:00",
    "updated_at": "2026-09-16T14:32:00+08:00",
    "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
    "user_uuid": "usr_9182309182",
    "module_type": 1,
    "role": "user",
    "content": "最近没有更换食物。",
    "content_type": 1,
    "stage": 2,
    "parent_session": null,
    "image": null,
    "evaluation": null,
    "extra_json": null,
    "is_hidden": 0
  }
}

响应字段 ​

参数名类型说明
idinteger消息主键 ID。
session_idstring所属会话 ID。
rolestring发言角色:user、assistant、system。
contentstring消息文本或 JSON 字符串。
content_typeinteger1 文本、2 图片、3 JSON。
module_typeinteger1 智能问诊、5 图片识别。
stageinteger/null业务阶段序号。
parent_sessionstring/null父会话 ID。
imagestring/null图片消息的图片 URL。
extra_jsonobject/null扩展信息。
is_hiddeninteger是否隐藏:0 否、1 是。
evaluationobject/null用户评价内容,未评价时为 null。
created_at / updated_atdatetime创建与更新时间(UTC+8,无时区偏移)。
user_uuidstring平台内部用户标识,不对外使用。

常见错误 ​

HTTP / codemessage触发条件
400role 仅支持 user/assistant/systemrole 传了其他值。
404会话不存在session_id 不存在或不属于当前调用方。
422Field required缺少 session_id、role 或 content。

说明 ​

  • 每轮回答只保存一次;客户端重试时不要重复提交。
  • 保存成功后按流程调用判断是否继续追问或直接进入下一轮。
最近更新

栖界开放平台 · API Documentation