本文介绍胸部CT平扫筛查ScreenChestCT的语法及示例。
功能描述
胸部CT平扫筛查基于常规胸部CT影像,实现了人体胸部多器官及多病种的检测及量化分析,主要功能如下:
1. 基于常规胸部CT自动测量冠状动脉的钙化积分值。
2. 自动检出肺结节,输出结节体积、平均灰度和AI结构化报告。
3. 自动分割肺叶区域肺炎病灶,输出病灶的大小和肺炎的类型等信息。
4. 检出肋骨骨折,并给出骨折的类型。
应用场景
胸部CT平扫筛查与医疗影像应用集成后,面向医院、区域医共体医联体、体检机构以及第三方影像中心等机构的影像医生、临床医生提供常规胸部CT影像检测及量化分析。
特色优势
功能丰富,首次实现通过一次CT扫描和一次上传即可完成多器官和多病种的检测和量化分析。
前提条件
输入限制
- 图片格式:JPEG、JPG、PNG、DCM。
- 图像大小:不超过3M。
- 图像分辨率:不小于5×5像素。
- 图像帧数:至少20帧,至多600帧。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ScreenChestCT |
系统规定参数。取值:ScreenChestCT。 |
DataFormat | String | 是 | DICOM |
图片的格式。目前仅支持DICOM。 |
OrgId | String | 是 | 7ff51bfe-e73d-11ea-827d-506b4b3f3cf6 |
数据来源机构代码。 |
OrgName | String | 是 | weiyi |
数据来源机构名称。 |
URLList.N.URL | String | 是 | https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727647871015858256476470406.dcm |
图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
CACS | Struct |
钙化积分计算算法的输出结果 |
|
ResultUrl | String | http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iB16ms28Y5mzB11ghYUd7upCi4**** |
分割结果下载地址,有效时间5分钟。 |
Score | String | 4.83 |
冠脉钙化积分值。 |
Covid | Struct |
新冠肺炎算法的输出结果 |
|
LesionRatio | String | 0.9387283236994219 |
白化比例。 |
Mask | String | http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF**** |
NII格式的mask文件HTTP地址。 |
NewProbability | String | 4.062644e-06 |
新冠肺炎概率。 |
NormalProbability | String | 0.7230905 |
普通肺炎的概率。 |
OtherProbability | String | 0.27690542 |
其他概率。 |
LungNodule | Struct |
肺结节检测算法的输出结果。 |
|
Series | Array of Serie |
本次影像分析的分序列的结果,只支持单序列,故该jsonArray的长度为1。数组元素为单个序列的检测结果,由analysisResult和seriesInstanceUid构成。 |
|
Elements | Array of Element |
结节描述。 |
|
Category | String | 1 |
结节分类,取值包括:0-ggo(磨玻璃影)、1-part-solid(部分实性)、2-solid(实性)及3-unknown(未知)。 |
Confidence | Float | 0.7012705768508907 |
结节分类的置信度。 |
Diameter | Float | 9.730626493692398 |
结节的直径。 |
ImageX | Float | 308.9676976455463 |
结节在图像坐标系中的x轴坐标值。 |
ImageY | Float | 198.3552282631497 |
结节在图像坐标系中的y轴坐标值。 |
ImageZ | Float | 198.3552282631497 |
结节在图像坐标系中的z轴坐标值。 |
Lobe | String | up |
肺叶分段。取值包括:up(上叶)、middle(中叶)、down(下叶)及unknown(未知)。 |
Lung | String | left |
结节在肺叶的位置。取值包括:left(左肺)、right(右肺)及unknown(未知)。 |
MeanValue | Float | 261.37589112119247 |
平均CT值,单位为HU。 |
SOPInstanceUID | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013 |
结节中心位置所在帧的ID标识。 |
Volume | Float | 10959.220491175074 |
结节体积,单位为mm³。 |
X | Float | 51.24291240631416 |
结节在物理坐标系中的x轴坐标值。 |
Y | Float | -32.23147700784307 |
结节在物理坐标系中的y轴坐标值。 |
Z | Float | -46.81608170781766 |
结节在物理坐标系中的z轴坐标值。 |
Origin | List | [-166.0,-171.6999969482422,-340.0] |
图像坐标系原点在物理坐标系中的位置。 |
Report | String | 肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。 |
该DICOM序列经过AI分析后AI服务给出的参考报告。 |
SeriesInstanceUid | String | 1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192 |
本次分析影像的序列ID。 |
Spacing | List | [0.703125,0.703125,14.34782600402832] |
每个像素的实际距离间隔。 |
RequestId | String | cffdd6be-361f-4193-bcdb-ef8de7b5d8b6 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ScreenChestCT
&DataFormat=DICOM
&OrgId=7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
&OrgName=测试
&URLList.1.URL={
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727647871015858256476470406.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727657330015858256476570740.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727664632015858256476640472.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727671581015858256476710276.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727682000015858256476820630.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727689573015858256476890560.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727696236015858256476960963.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727702380015858256477020470.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727708457015858256477080784.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727714853015858256477140030.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727721155015858256477210051.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727728111015858256477280255.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727735617015858256477350717.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727742615015858256477420727.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727750020015858256477500873.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727757243015858256477570387.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727764561015858256477640878.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727771730015858256477710828.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727778986015858256477790498.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727785888015858256477850713.dcm"
},
{
"url":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727792794015858256477920390.dcm"
}
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>cffdd6be-361f-4193-bcdb-ef8de7b5d8b6</RequestId>
<Data>
<LungNodule>
<Series>
<Report>肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。</Report>
<SeriesInstanceUid>1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192</SeriesInstanceUid>
</Series>
<Series>
<Elements>
<ImageZ>198.3552282631497</ImageZ>
<ImageY>198.3552282631497</ImageY>
<ImageX>308.9676976455463</ImageX>
<Lobe>up</Lobe>
<Category>1</Category>
<Lung>left</Lung>
<MeanValue>261.37589112119247</MeanValue>
<Volume>10959.220491175074</Volume>
<Confidence>0.7012705768508907</Confidence>
<X>51.24291240631416</X>
<Y>-32.23147700784307</Y>
<Z>-46.81608170781766</Z>
<SOPInstanceUID>1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013</SOPInstanceUID>
<Diameter>9.730626493692398</Diameter>
</Elements>
</Series>
<Series>
<Origin>[-166.0,-171.6999969482422,-340.0]</Origin>
<Spacing>[0.703125,0.703125,14.34782600402832]</Spacing>
</Series>
</LungNodule>
<CACS>
<Score>4.83</Score>
<ResultUrl>http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iB16ms28Y5mzB11ghYUd7upCi4****</ResultUrl>
</CACS>
<Covid>
<NewProbability>4.062644e-06</NewProbability>
<OtherProbability>0.27690542</OtherProbability>
<NormalProbability>0.7230905</NormalProbability>
<Mask>http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****</Mask>
<LesionRatio>0.9387283236994219</LesionRatio>
</Covid>
</Data>
JSON
格式
{
"RequestId": "cffdd6be-361f-4193-bcdb-ef8de7b5d8b6",
"Data": {
"LungNodule": {
"Series": [
{
"Report": "肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。",
"SeriesInstanceUid": "1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192"
},
{
"Elements": {
"ImageZ": 198.3552282631497,
"ImageY": 198.3552282631497,
"ImageX": 308.9676976455463,
"Lobe": "up",
"Category": 1,
"Lung": "left",
"MeanValue": 261.37589112119247,
"Volume": 10959.220491175074,
"Confidence": 0.7012705768508907,
"X": 51.24291240631416,
"Y": -32.23147700784307,
"Z": -46.81608170781766,
"SOPInstanceUID": "1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013",
"Diameter": 9.730626493692398
}
},
{
"Origin": "[-166.0,-171.6999969482422,-340.0]",
"Spacing": "[0.703125,0.703125,14.34782600402832]"
}
]
},
"CACS": {
"Score": 4.83,
"ResultUrl": "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/calc-cacs/2020-09-29/2020-09-29-11%3A07%3A41-D74FE0DF-8F80-41EB-B08B-2E67053587EC.tar.gz?Expires=1601350661&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iB16ms28Y5mzB11ghYUd7upCi4****"
},
"Covid": {
"NewProbability": 0.000004062644,
"OtherProbability": 0.27690542,
"NormalProbability": 0.7230905,
"Mask": "http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****",
"LesionRatio": 0.9387283236994219
}
}
}
查询任务结果
该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果。
错误码
关于胸部CT平扫筛查的错误码。详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交