Skip to content

提交问诊图片补充识别 ​

在问诊流程中上传并提交患处或体征照片。服务端接收图片并触发视觉识别分析,将识别特征自动沉淀进问诊上下文,供后续生成小结和报告使用。

业务交互说明:识别结果不向用户展示

本接口返回的 analysis(图片识别结果)主要用于服务端沉淀问诊上下文,供后续生成小结(summary)与生成报告(report)时模型参考:

  • 前端交互:图片分析完成后,无需将识别结果展示给用户。
  • 后续动作:收到本接口成功响应后,前端直接流转进入下一步调用生成问诊小结接口即可。

请求地址 ​

POST
/v1/ms-ai-fast/ai-doc/pic-result

请求参数 ​

请求头 ​

请求头类型必填说明
Authorizationstring是访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。
Content-Typestring是请求体格式,固定为 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_idstring是会话唯一标识符。
img_urlstring是当前用户通过 /oss/images 上传且状态为 ready 的图片 URL;不得使用第三方地址或自行拼接的对象地址。
pet_profile_idinteger否兼容字段;若传入必须与会话绑定的档案一致。
langstring否若传入必须与会话语言一致。

图片抓取约束

服务端会主动抓取该 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_idstring关联的会话 ID。
report_idinteger/null关联的报告 ID。
taskobject/null本接口同步返回识别结果,正常为 null,无需轮询。
analysisobject图片补充识别结果。内部用于服务端上下文沉淀,前端无需展示。
analysis.contentstring识别文本,通常是 JSON 字符串(内部可能包含 recg、result、advice 等结构)。
analysis.img_urlstring本次识别使用的图片 URL。
analysis.sub_module_typeinteger本次识别使用的能力类型(1~8)。
analysis.gateway_request_idstring/null网关请求标识。

analysis.content 的内部结构由模型决定(仅用于服务端上下文,不应展示在前端 UI;示例中的 recg 仅为示意)。

最近更新

栖界开放平台 · API Documentation