提交问诊报告任务
问诊流程结束后提交一次异步报告生成任务。任务成功后返回 report_id(即 medical_record.id),再通过通用接口读取完整报告。
报告全字段定义与前端渲染对照
关于报告对象(report)内部所有字段(主诉、严重度枚举、体表与器官高亮、三阶段用药治疗方案、兽医嘱咐等)的详细定义与页面 UI 映射,请直接查阅:
👉 《智能问诊报告字段详解与页面映射》
请求地址
POST
/v1/ms-ai-fast/ai-doc/report
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body)
json
{
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"report_type": 1
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | 会话唯一标识符,由创建会话接口生成。 |
report_type | integer | 否 | 报告分片类型,默认 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
}
}响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示任务已受理。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
session_id | string | 关联的当前会话 ID。 |
report_id | integer/null | 报告 ID,即 medical_record.id;任务尚未完成时为 null,可用 GET /medical-record?session_id= 直接读取(可能仍在生成)。 |
task | object/null | 异步报告任务对象;为 null 表示报告已同步生成,不要再轮询。 |
task.task_id | string | 任务唯一 ID,用于 GET /ai-tasks/{task_id} 轮询。 |
task.task_type | string | 任务类型,报告任务固定为 ai_doc_report_generate。 |
task.status | string | 任务状态:pending、processing、retrying、succeeded、failed、canceled。 |
task.progress | integer | 任务进度百分比(0~100)。 |
task.result_payload_json | object/null | 公开结果摘要,仅包含 report_type 与 gateway_request_id。 |
task.error_code | integer/null | 任务失败时的公开数字错误码。 |
task.started_at | string/null | 任务开始时间(UTC,无时区偏移)。 |
task.finished_at | string/null | 任务完成时间(UTC,无时区偏移)。 |
task.created_at | string | 任务创建时间(UTC+8,无时区偏移)。 |
task.updated_at | string | 任务更新时间(UTC+8,无时区偏移)。 |
analysis | object/null | 同步图片补充识别结果;报告任务固定为 null。 |
后续步骤与轮询
task.task_id存在时,用GET /ai-tasks/{task_id}轮询:每 4 秒一次,最长 5 分钟(实测报告生成约 20~30 秒);状态进入succeeded、failed、canceled后立即停止。task为null时,说明报告已同步返回,直接用report_id或GET /medical-record?session_id=读取。failed/canceled时,用重试失败任务重试,不要为同一会话重复创建报告任务。