本文介绍胸部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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****",
            "LesionRatio": 0.9387283236994219
        }
    }
}

查询任务结果

该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果。

错误码

关于胸部CT平扫筛查的错误码。详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。