腾讯觅影肺炎 CT 辅助评估

要解决什么问题

胸部 CT 的肺炎评估往往依赖人工阅片与病灶勾画，在科研或院内流程里，若需要批量、可复现地拿到「是否有肺炎表征」以及分肺叶的感染占比与病灶体积，直接对接影像 AI 后端比手写 HTTP 客户端更省事。本技能封装腾讯健康觅影的肺炎模型开放接口：用 studyId 标识一次检查，上传 ZIP 格式的 DICOM 序列（单包最大 300MB），再按 taskId 查询或自动轮询直到分析结束。

技能如何工作

鉴权采用 HMAC-SHA256：请求头携带 appId、timestamp、signature，token 仅用于服务端签名，不得出现在前端或日志中。

典型流程分三步：

1. 提交：POST https://pacs.qq.com/openapi/pneumoniaSubmit，multipart/form-data 上传 dicomFile 与必填 studyId；成功时 head.code=0，并得到 head.taskId（格式 {studyId}_{毫秒时间戳}）。
2. 查询：POST https://pacs.qq.com/openapi/pneumoniaQuery，JSON 体传 taskId（多个可用 ; 分隔）；status 为「待处理 / 处理中 / 处理完成 / 处理失败」。
3. 轮询：技能提供脚本按间隔重试查询，默认建议提交后先等待约 30 秒再查（分析常见 3～10 分钟）。

结果侧重点读 pneumoniaSign（如肺炎表征概率）与 pneumoniaAnalysis：全肺/左右肺感染占比，以及按肺叶、层号范围、体积、平均 CT 值（HU）列出的病灶详情；若 needReport=1 且完成，可拿到 PDF 报告的 reportUrl。

适用边界与注意点

特别说明：模型能力仅限中国大陆地区科研用途售卖与使用，不得直接用于临床检测与诊疗。

• ZIP 内应为有效 DICOM，避免 __MACOSX 等杂项；序列宜 >10 张 CT 层，否则可能回退使用全部图像。
• 本地时钟需与 NTP 对齐，否则易出现 INVALID_TOKEN / INVALID_SIGNATURE。
• 关注 head.resourceRemaining 与签约并发；相同文件不同 studyId 重复提交会分别计费；超过 24 小时未完成任务可能被标记失败并移除。