创建图片识别会话
创建独立的图片特征识别会话。会话将绑定宠物档案、识别子类型及语言,作为后续流式识别与生成报告的上下文容器。
请求地址
POST
/v1/ms-ai-fast/session-records/sessions
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 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_type | integer | 是 | 业务模块类型,图片特征识别固定传 5。 |
pet_profile_id | integer | 是 | 绑定的数字宠物档案 ID(必须大于 0)。 |
sub_module_type | integer | 否 | 识别细分子类型:1 品种识别、2 表情识别、3 口腔/牙齿识别、4 排泄物识别、5 呕吐物识别、6 皮肤识别、7 耳道识别、8 眼睛识别。Schema 上可省略,但图片识别后续步骤要求与会话锁定值一致,实际必须传入,且创建后不可修改。 |
lang | string | 否 | 会话语言代码,默认 zh-CN。支持 zh-CN 与 en-US。 |
trace_id | string | 否 | 调用方自定义全链路追踪 ID(可选)。 |
content | string/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
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示成功。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 返回数据外层对象。 |
session_id | string | 图片识别会话唯一 ID。作为后续流式分析与生成报告的全局核心凭证。 |
medical_record_id | integer | 本次识别任务关联的病历主记录 ID。 |
medical_record | object | 系统生成的病历主记录对象详情。 |
medical_record.id | integer | 病历记录自增主键 ID。 |
medical_record.pet_profile_id | integer | 绑定的宠物档案 ID。 |
medical_record.module_type | integer | 模块类型:5。 |
medical_record.status | integer | 业务状态:2 表示已激活正常进行中。 |
medical_record.lang | string | 本次会话锁定的语言代码。 |
medical_record.created_at | string | 病历记录创建时间(UTC+8)。 |
initial_message | object/null | 初始系统消息对象:当请求体传入 content 时返回该流程的首条消息;本例未传 content,因此为 null。 |