接口说明
功能描述
胸部 CT 平扫筛查能力基于常规胸部 CT 影像,实现了人体胸部多器官及多病种的检测及量化分析,主要功能如下:
- 基于常规胸部 CT 自动测量冠状动脉的钙化积分值。
- 自动检出肺结节,输出结节体积、平均灰度和 AI 结构化报告。
- 自动分割肺叶区域肺炎病灶,输出病灶的大小和肺炎的类型等信息。
- 检出肋骨骨折,并给出骨折的类型。
- 可检测胸部平扫或增强 CT 中的肿大淋巴结,包含胸部的纵膈、肺门和锁骨上淋巴结。
- 根据输入的胸部平扫 CT 评估胰腺癌风险。
应用场景
胸部 CT 平扫筛查与医疗影像应用集成后,面向医院、区域医共体医联体、体检机构以及第三方影像中心等机构的影像医生、临床医生提供常规胸部 CT 影像检测及量化分析。
特色优势
功能丰富,首次实现通过一次 CT 扫描和一次上传即可完成多器官和多病种的检测和量化分析。
接入指引
-
注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
-
创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权。
-
在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
-
开发接入:能力支持 SDK 方式调用,您可以选择合适的开发语言进行接入,具体操作,请参见 SDK 总览。
-
示例代码:该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码。
-
客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:DICOM。
- 图像大小:不超过 3 MB。
- 图像分辨率:小于等于 512×512 像素。
- 图像帧数:至少 20 帧,至多 1600 帧。
- URL 地址中不能包含中文字符。
调用步骤
该能力为异步能力,需分两步进行调用。 第一步调用 ScreenChestCT 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。
计费说明
关于胸部 CT 平扫筛查的计费方式及报价,请参见计费介绍。
流控信息
请求参数
字段名称 | 字段详情 |
---|---|
DataFormatstring | 图片的格式。目前仅支持 DICOM。 示例值:DICOM |
OrgNamestring | 数据来源机构名称。 示例值:weiyi |
OrgIdstring | 数据来源机构代码。 示例值:7ff51bfe-e73d-11ea-827d-506b4b3f3cf6 |
URLListarray<object> | DICOM 序列的地址列表。 子级条数 <= 1600 |
Maskinteger<int64> | |
Verboseinteger<int64> | 是否在返回参数中输出相关字段,取值 0、1 和 2,默认为 0。展开详情 注意
该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。 示例值:0 |
请求说明
算法启用与 Mask 值对应关系
Mask | 对应二进制数 | 二进制中对应位置(由低到高位) | 描述 |
---|---|---|---|
1 | 1 | 1 | 二进制第一 bit 位为 1,代表启用新冠病毒肺炎辅助诊断算法。 |
2 | 10 | 2 | 二进制第二 bit 位为 1,代表启用冠脉钙化积分测算算法。 |
4 | 100 | 3 | 二进制第三 bit 位为 1,代表启用胸部 CT 肺结节检测算法。 |
8 | 1000 | 4 | 二进制第四 bit 位为 1,代表启用肋骨骨折检测算法。 |
16 | 10000 | 5 | 二进制第五 bit 位为 1,代表启用主动脉瘤肺动脉高压检测算法。 |
32 | 100000 | 6 | 二进制第六 bit 位为 1,代表启用淋巴结检测算法。 |
64 | 1000000 | 7 | 二进制第七 bit 位为 1,代表启用胰腺癌检测算法。 |
128 | 10000000 | 8 | 二进制第八 bit 位为 1,代表启用食管癌检测算法。 |
256 | 0000000100000000 | 9 | 二进制第九 bit 位为 1,代表启用骨密度估计算法。 |
512 | 0000001000000000 | 10 | 二进制第十 bit 位为 1,代表启用脂肪肝检测算法。 |
1024 | 0000010000000000 | 11 | 二进制第十一 bit 位为 1,代表启用胃癌检测算法。 |
2048 | 0000100000000000 | 12 | 二进制第十二 bit 位为 1,代表启用结直肠癌检测算法。 |
4096 | 0001000000000000 | 13 | 二进制第十三 bit 位为 1,代表启用肝癌检测算法。 |
8192 | 0010000000000000 | 14 | 二进制第十四 bit 位为 1,代表启用 CVD 心血管不良事件检测算法。 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID。 示例值:528B54D4-3AAB-47CF-B6CE-0C2A2FB4C7C2 |
Dataobject | 返回的结果数据内容。该数据需要在异步任务执行成功后,通过调用 GetAsyncJobResult 接口,对其 Result 字段进行 JSON 反序列化之后得到。 |
Messagestring | 提交异步任务后的提示信息。 示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。 |
返回说明
查询结果
该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult 。
SDK 参考
阿里云视觉 AI 能力推荐使用 SDK 调用,支持多种编程语言,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览。
示例代码
该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码。