提交问诊图片补充识别
在问诊流程中上传并提交患处或体征照片。服务端接收图片并触发视觉识别分析,将识别特征自动沉淀进问诊上下文,供后续生成小结和报告使用。
业务交互说明:识别结果不向用户展示
本接口返回的 analysis(图片识别结果)主要用于服务端沉淀问诊上下文,供后续生成小结(summary)与生成报告(report)时模型参考:
- 前端交互:图片分析完成后,无需将识别结果展示给用户。
- 后续动作:收到本接口成功响应后,前端直接流转进入下一步调用生成问诊小结接口即可。
请求地址
POST
/v1/ms-ai-fast/ai-doc/pic-result
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body)
json
{
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"pet_profile_id": 44,
"img_url": "https://cdn.habitaxx.com/uploads/consult/vomit_01.jpg",
"lang": "zh-CN"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | 会话唯一标识符。 |
img_url | string | 是 | 当前用户通过 /oss/images 上传且状态为 ready 的图片 URL;不得使用第三方地址或自行拼接的对象地址。 |
pet_profile_id | integer | 否 | 兼容字段;若传入必须与会话绑定的档案一致。 |
lang | string | 否 | 若传入必须与会话语言一致。 |
图片抓取约束
服务端会主动抓取该 URL,并做以下限制:最多 3 次重定向、远端图片最大 20 MiB、有抓取超时。典型失败为 400,内部原因标识包括 AI_PIC_IMAGE_URL_INVALID、AI_PIC_IMAGE_PRIVATE_ADDRESS_FORBIDDEN、AI_PIC_IMAGE_FETCH_TIMEOUT、AI_PIC_IMAGE_REDIRECT_LIMIT_EXCEEDED,公开数字错误码见错误处理。服务端对图片识别会自动重试,调用方不要对同一请求无限重试。
响应示例
json
{
"code": 200,
"message": "success",
"data": {
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"report_id": null,
"task": null,
"analysis": {
"content": "{\n \"overall_health_status\": \"健康\",\n \"recg\": {\"photo\": \"非宠物皮肤图片,请检查\"}\n}",
"img_url": "https://cdn.habitaxx.com/uploads/consult/vomit_01.jpg",
"sub_module_type": 6,
"gateway_request_id": "gw_req_581902"
}
}
}响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
session_id | string | 关联的会话 ID。 |
report_id | integer/null | 关联的报告 ID。 |
task | object/null | 本接口同步返回识别结果,正常为 null,无需轮询。 |
analysis | object | 图片补充识别结果。内部用于服务端上下文沉淀,前端无需展示。 |
analysis.content | string | 识别文本,通常是 JSON 字符串(内部可能包含 recg、result、advice 等结构)。 |
analysis.img_url | string | 本次识别使用的图片 URL。 |
analysis.sub_module_type | integer | 本次识别使用的能力类型(1~8)。 |
analysis.gateway_request_id | string/null | 网关请求标识。 |
analysis.content 的内部结构由模型决定(仅用于服务端上下文,不应展示在前端 UI;示例中的 recg 仅为示意)。