Skip to content

创建图片识别报告任务 ​

在图片识别小结完成后发起异步生成完整识别报告任务。报告深度解构疾病风险、多维度病理分析、用药指导与护理建议。

3套报告体系字段与前端页面渲染

图片识别针对不同 sub_module_type 提供了品种、情绪、通用体征等 3 套报告数据模型。全量字段定义与前端组件渲染指引,请查阅:
👉 《图片识别报告字段详解与页面映射》

请求地址 ​

POST
/v1/ms-ai-fast/ai-pic/sessions/report-tasks

请求参数 ​

请求头 ​

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

请求体 (Body) ​

json
{
  "session_id": "pic_session_6407c5cc22f84c5aae0aeba23e1f1428",
  "img_url": "https://cdn.habitaxx.com/uploads/2026/09/16/pet_skin_01.jpg"
}
参数名类型必填说明
session_idstring是已完成识别的会话唯一 ID。
img_urlstring是该会话分析的同一张图片公网 URL。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "session_id": "pic_session_6407c5cc22f84c5aae0aeba23e1f1428",
    "report_id": 10088,
    "task": {
      "task_id": "task_pic_rep_781923019",
      "task_type": "ai_pic_report_generate",
      "status": "pending",
      "progress": 0,
      "result_payload_json": null,
      "error_code": null,
      "started_at": null,
      "finished_at": null,
      "created_at": "2026-09-16T14:38:50+08:00",
      "updated_at": "2026-09-16T14:38:50+08:00"
    }
  }
}
参数名类型说明
codeinteger业务状态码,200 表示已成功创建报告生成任务。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
dataobject返回数据包装对象。
session_idstring关联的会话 ID。
report_idinteger/null生成的目标报告 ID;任务尚未完成时为 null。报告生成成功后,直接通过通用接口 GET /medical-record?report_id={report_id} 读取。
taskobject异步生成任务详情。
task.task_idstring异步任务唯一 ID。调用通用接口 GET /ai-tasks/{task_id} 轮询任务状态直至 succeeded。
task.task_typestring任务类型标识,固定为 "ai_pic_report_generate"。
task.statusstring任务状态:pending(排队中)、processing(处理中)、retrying(重试中)、succeeded(成功)、failed(失败)、canceled(已取消)。
task.progressinteger任务进度百分比(0~100)。
task.result_payload_jsonobject/null公开的结果摘要。
task.error_codeinteger/null公开的数值错误码;仅任务失败时才有值。
task.started_atdatetime/null任务开始时间(UTC,无时区偏移)。
task.finished_atdatetime/null任务结束时间(UTC,无时区偏移)。
task.created_atdatetime/null任务创建时间(UTC+8,无时区偏移)。
task.updated_atdatetime/null任务更新时间(UTC+8,无时区偏移)。

任务对象不返回 error_key、error_message、retryable、recommended_action;可重试性请按任务级错误码表判断。任务失败时 HTTP 状态码与 code 仍为 200,需通过 task.status 判断是否失败。

最近更新

栖界开放平台 · API Documentation