本文介绍胸部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小时后会被系统自动清理删除。