创建图片识别报告任务
在图片识别小结完成后发起异步生成完整识别报告任务。报告深度解构疾病风险、多维度病理分析、用药指导与护理建议。
3套报告体系字段与前端页面渲染
图片识别针对不同 sub_module_type 提供了品种、情绪、通用体征等 3 套报告数据模型。全量字段定义与前端组件渲染指引,请查阅:
👉 《图片识别报告字段详解与页面映射》
请求地址
POST
/v1/ms-ai-fast/ai-pic/sessions/report-tasks
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body)
json
{
"session_id": "pic_session_6407c5cc22f84c5aae0aeba23e1f1428",
"img_url": "https://cdn.habitaxx.com/uploads/2026/09/16/pet_skin_01.jpg"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | 已完成识别的会话唯一 ID。 |
img_url | string | 是 | 该会话分析的同一张图片公网 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"
}
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示已成功创建报告生成任务。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 返回数据包装对象。 |
session_id | string | 关联的会话 ID。 |
report_id | integer/null | 生成的目标报告 ID;任务尚未完成时为 null。报告生成成功后,直接通过通用接口 GET /medical-record?report_id={report_id} 读取。 |
task | object | 异步生成任务详情。 |
task.task_id | string | 异步任务唯一 ID。调用通用接口 GET /ai-tasks/{task_id} 轮询任务状态直至 succeeded。 |
task.task_type | string | 任务类型标识,固定为 "ai_pic_report_generate"。 |
task.status | string | 任务状态:pending(排队中)、processing(处理中)、retrying(重试中)、succeeded(成功)、failed(失败)、canceled(已取消)。 |
task.progress | integer | 任务进度百分比(0~100)。 |
task.result_payload_json | object/null | 公开的结果摘要。 |
task.error_code | integer/null | 公开的数值错误码;仅任务失败时才有值。 |
task.started_at | datetime/null | 任务开始时间(UTC,无时区偏移)。 |
task.finished_at | datetime/null | 任务结束时间(UTC,无时区偏移)。 |
task.created_at | datetime/null | 任务创建时间(UTC+8,无时区偏移)。 |
task.updated_at | datetime/null | 任务更新时间(UTC+8,无时区偏移)。 |
任务对象不返回 error_key、error_message、retryable、recommended_action;可重试性请按任务级错误码表判断。任务失败时 HTTP 状态码与 code 仍为 200,需通过 task.status 判断是否失败。