Skip to content

创建问诊会话 ​

创建新的智能问诊会话,保存初始主诉,并生成唯一的会话标识(session_id),作为后续所有多轮问答、推理解析、小结与报告接口的上下文凭证。

请求地址 ​

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

请求参数 ​

请求头 ​

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

请求体 (Body) ​

json
{
  "module_type": 1,
  "pet_profile_id": 44,
  "content": "我的猫今天呕吐了三次,精神状态一般。",
  "lang": "zh-CN",
  "trace_id": "consult-20260914-0001"
}
参数名类型必填说明
module_typeinteger是业务模块编号:1 智能问诊,5 宠物图片识别。本接口固定传 1。
pet_profile_idinteger是宠物档案 ID(数字),必须大于 0。
contentstring是初始主诉或首条用户病情描述文本,不能传空字符串。
langstring否会话语言代码,默认值为 zh-CN。当前支持 zh-CN 与 en-US。
trace_idstring否调用方自定义全链路追踪标识,用于排查请求链路,最长 100 字符。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "session_id": "doc_6407c5cc22f84c5aae0aeba23e1f1428",
    "medical_record_id": 10001,
    "medical_record": {
      "id": 10001,
      "pet_profile_id": 44,
      "module_type": 1,
      "status": 1,
      "lang": "zh-CN",
      "created_at": "2026-09-14T10:00:00"
    },
    "initial_message": {
      "id": 1,
      "role": "user",
      "content": "我的猫今天呕吐了三次,精神状态一般。",
      "content_type": 1,
      "created_at": "2026-09-14T10:00:00"
    }
  }
}
参数名类型说明
codeinteger业务状态码,200 表示处理成功。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
dataobject返回数据主体包装对象。
session_idstring核心会话标识。后续发起多轮问答、提取关键词、生成推理解析、生成小结与报告时必须传入该值。
medical_record_idinteger关联的 AI 主病历记录 ID。
medical_recordobject生成的 AI 主病历记录详情。
medical_record.idinteger病历记录 ID,与 medical_record_id 一致。
medical_record.pet_profile_idinteger关联的宠物档案 ID。
medical_record.module_typeinteger业务模块:1 智能问诊。
medical_record.statusinteger业务状态:实测会话刚创建时为 1,报告完成后为 2;判断报告是否完成请用 report_status。
medical_record.langstring会话语言(如 zh-CN)。
medical_record.created_atstring病历创建时间(ISO 8601 格式)。
initial_messageobject系统保存的首条主诉消息对象。
initial_message.idinteger首条消息自增 ID。
initial_message.rolestring发言者角色:固定为 "user"(用户)。
initial_message.contentstring主诉文本内容(与请求入参 content 一致)。
initial_message.content_typeinteger消息类型:1 文本,2 图片,3 JSON。此处固定为 1。
initial_message.created_atstring消息写入时间(ISO 8601 格式)。
最近更新

栖界开放平台 · API Documentation