Skip to content

创建图片识别会话 ​

创建独立的图片特征识别会话。会话将绑定宠物档案、识别子类型及语言,作为后续流式识别与生成报告的上下文容器。

请求地址 ​

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

请求参数 ​

请求头 ​

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

请求体 (Body) ​

json
{
  "module_type": 5,
  "pet_profile_id": 44,
  "sub_module_type": 3,
  "lang": "zh-CN",
  "trace_id": "trace_pic_demo_20260916_01"
}
参数名类型必填说明
module_typeinteger是业务模块类型,图片特征识别固定传 5。
pet_profile_idinteger是绑定的数字宠物档案 ID(必须大于 0)。
sub_module_typeinteger否识别细分子类型:1 品种识别、2 表情识别、3 口腔/牙齿识别、4 排泄物识别、5 呕吐物识别、6 皮肤识别、7 耳道识别、8 眼睛识别。Schema 上可省略,但图片识别后续步骤要求与会话锁定值一致,实际必须传入,且创建后不可修改。
langstring否会话语言代码,默认 zh-CN。支持 zh-CN 与 en-US。
trace_idstring否调用方自定义全链路追踪 ID(可选)。
contentstring/null否初始主诉;图片识别通常不传,传了会生成首条消息。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "session_id": "pic_6407c5cc22f84c5aae0aeba23e1f1428",
    "medical_record_id": 10088,
    "medical_record": {
      "id": 10088,
      "pet_profile_id": 44,
      "module_type": 5,
      "status": 2,
      "lang": "zh-CN",
      "created_at": "2026-09-16T14:30:00"
    },
    "initial_message": null
  }
}
参数名类型说明
codeinteger业务状态码,200 表示成功。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
dataobject返回数据外层对象。
session_idstring图片识别会话唯一 ID。作为后续流式分析与生成报告的全局核心凭证。
medical_record_idinteger本次识别任务关联的病历主记录 ID。
medical_recordobject系统生成的病历主记录对象详情。
medical_record.idinteger病历记录自增主键 ID。
medical_record.pet_profile_idinteger绑定的宠物档案 ID。
medical_record.module_typeinteger模块类型:5。
medical_record.statusinteger业务状态:2 表示已激活正常进行中。
medical_record.langstring本次会话锁定的语言代码。
medical_record.created_atstring病历记录创建时间(UTC+8)。
initial_messageobject/null初始系统消息对象:当请求体传入 content 时返回该流程的首条消息;本例未传 content,因此为 null。
最近更新

栖界开放平台 · API Documentation