Skip to content

提交问诊报告任务 ​

问诊流程结束后提交一次异步报告生成任务。任务成功后返回 report_id(即 medical_record.id),再通过通用接口读取完整报告。

报告全字段定义与前端渲染对照

关于报告对象(report)内部所有字段(主诉、严重度枚举、体表与器官高亮、三阶段用药治疗方案、兽医嘱咐等)的详细定义与页面 UI 映射,请直接查阅:
👉 《智能问诊报告字段详解与页面映射》

请求地址 ​

POST
/v1/ms-ai-fast/ai-doc/report

请求参数 ​

请求头 ​

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

请求体 (Body) ​

json
{
  "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
  "report_type": 1
}
参数名类型必填说明
session_idstring是会话唯一标识符,由创建会话接口生成。
report_typeinteger否报告分片类型,默认 1;仅允许 1、2、3、4、7。每个会话只提交一次任务,不要按分片重复提交。

report_type 取值(报告分片):

report_type对应分片
1病情回顾
2诊断结果
3治疗建议
4兽医嘱咐
7补充建议

平台一次任务会生成全部分片,report_type 只影响本次任务的上下文(1 会带上图片识别结果)。分片内容通过 report_contents[].report_index 读取,取值与上表的 report_type 一一对应。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
    "report_id": 10086,
    "task": {
      "task_id": "task_89234710294",
      "task_type": "ai_doc_report_generate",
      "status": "pending",
      "progress": 0,
      "result_payload_json": null,
      "error_code": null,
      "started_at": null,
      "finished_at": null,
      "created_at": "2026-09-16T14:56:21+08:00",
      "updated_at": "2026-09-16T14:56:21+08:00"
    },
    "analysis": null
  }
}

响应字段 ​

参数名类型说明
codeinteger业务状态码,200 表示任务已受理。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
session_idstring关联的当前会话 ID。
report_idinteger/null报告 ID,即 medical_record.id;任务尚未完成时为 null,可用 GET /medical-record?session_id= 直接读取(可能仍在生成)。
taskobject/null异步报告任务对象;为 null 表示报告已同步生成,不要再轮询。
task.task_idstring任务唯一 ID,用于 GET /ai-tasks/{task_id} 轮询。
task.task_typestring任务类型,报告任务固定为 ai_doc_report_generate。
task.statusstring任务状态:pending、processing、retrying、succeeded、failed、canceled。
task.progressinteger任务进度百分比(0~100)。
task.result_payload_jsonobject/null公开结果摘要,仅包含 report_type 与 gateway_request_id。
task.error_codeinteger/null任务失败时的公开数字错误码。
task.started_atstring/null任务开始时间(UTC,无时区偏移)。
task.finished_atstring/null任务完成时间(UTC,无时区偏移)。
task.created_atstring任务创建时间(UTC+8,无时区偏移)。
task.updated_atstring任务更新时间(UTC+8,无时区偏移)。
analysisobject/null同步图片补充识别结果;报告任务固定为 null。

后续步骤与轮询 ​

  1. task.task_id 存在时,用 GET /ai-tasks/{task_id} 轮询:每 4 秒一次,最长 5 分钟(实测报告生成约 20~30 秒);状态进入 succeeded、failed、canceled 后立即停止。
  2. task 为 null 时,说明报告已同步返回,直接用 report_id 或 GET /medical-record?session_id= 读取。
  3. failed / canceled 时,用重试失败任务重试,不要为同一会话重复创建报告任务。
最近更新

栖界开放平台 · API Documentation