本文介绍胸部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代码示例。

请求参数

名称 类型 是否必选 示例值 描述
DataFormat String DICOM

图片的格式。目前仅支持DICOM。

OrgName String weiyi

数据来源机构名称。

OrgId String 7ff51bfe-e73d-11ea-827d-506b4b3f3cf6

数据来源机构代码。

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

返回数据

名称 类型 示例值 描述
RequestId String cffdd6be-361f-4193-bcdb-ef8de7b5d8b6

请求ID。

Data object

返回的结果数据内容。

LungNodule object

肺结节检测算法的输出结果。

Series Array of Serie

本次影像分析的分序列的结果,只支持单序列,故该jsonArray的长度为1。数组元素为单个序列的检测结果,由analysisResult和seriesInstanceUid构成。

SeriesInstanceUid String 1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192

本次分析影像的序列ID。

Elements Array of Element

结节描述。

Lobe String up

肺叶分段。取值包括:up(上叶)、middle(中叶)、down(下叶)及unknown(未知)。

MeanValue Float 261.37589112119247

平均CT值,单位为HU。

Lung String left

结节在肺叶的位置。取值包括:left(左肺)、right(右肺)及unknown(未知)。

Confidence Float 0.7012705768508907

结节分类的置信度。

SOPInstanceUID String 1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013

结节中心位置所在帧的ID标识。

Category String 1

结节分类。取值包括:

  • 0:ggo(磨玻璃影)
  • 1:part-solid(部分实性)
  • 2:solid(实性)
  • 3:unknown(未知)
Volume Float 10959.220491175074

结节体积,单位为mm³。

Diameter Float 9.730626493692398

结节的直径。

X Float 51.24291240631416

结节在物理坐标系中的x轴坐标值。

Y Float -32.23147700784307

结节在物理坐标系中的y轴坐标值。

Z Float -46.81608170781766

结节在物理坐标系中的z轴坐标值。

ImageX Float 308.9676976455463

结节在图像坐标系中的x轴坐标值。

ImageY Float 198.3552282631497

结节在图像坐标系中的y轴坐标值。

ImageZ Float 198.3552282631497

结节在图像坐标系中的z轴坐标值。

Origin Array of Float [-166.0,-171.6999969482422,-340.0]

图像坐标系原点在物理坐标系中的位置。

Report String 肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。

该DICOM序列经过AI分析后AI服务给出的参考报告。

Spacing Array of Float [0.703125,0.703125,14.34782600402832]

每个像素的实际距离间隔。

CACS object

冠脉钙化积分测算算法的输出结果。

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 object

新冠肺炎算法的输出结果。

NormalProbability String 0.7230905

普通肺炎的概率。

NewProbability String 4.062644e-06

新冠肺炎概率。

LesionRatio String 0.9387283236994219

白化比例。

OtherProbability String 0.27690542

其他概率。

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地址。

DetectRibFracture object

肋骨骨折检测算法的输出结果。

ResultURL String http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****

分割结果下载地址,有效时间5分钟。

Spacing Array of Float [1.25,0.8261719942092896,0.8261719942092896]

每个像素之间的物理距离间隔。

Origin Array of Float [-431.9739990234375,-211.5,-204.01400756835938]

像素坐标系原点在物理坐标系中的位置。

Detections Array of Detections

肋骨骨折检出结果。

FractureId Long 2

骨折处序号,从1起始。

FractureConfidence Float 0.7916666666666667

骨折分类的置信度。

FractureCategory Long 1

骨折分类结果。

  • 1:移位骨折。
  • 2:非移位骨折。
  • 3:皮质弯曲。
  • 4:陈旧骨折。
Coordinates Array of Long [75,-98,-156,98,-80,-133]

物理坐标系下骨折检测框。

CoordinateImage Array of Long [338,137,220,366,159,239]

图像坐标系下骨折检测框。

FractureLocation String L4

骨折所在肋骨编号(L1~L12,R1~R12)。L表示左侧,R表示右侧。

FractureSegment Long 0

骨折所在肋骨段。取值如下:

  • 0:前段
  • 1:腋段
  • 2:后段

示例

请求示例

http(s)://[Endpoint]/?DataFormat=DICOM
&OrgName=weiyi
&OrgId=7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
&URLList=[{"URL":"https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/coronacases_org_001/1.2.112.92121.1.1689.19.2.20200402190727647871015858256476470406.dcm"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>cffdd6be-361f-4193-bcdb-ef8de7b5d8b6</RequestId>
<Data>
    <LungNodule>
        <Series>
            <SeriesInstanceUid>1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192</SeriesInstanceUid>
            <Elements>
                <Lobe>up</Lobe>
                <MeanValue>261.3759</MeanValue>
                <Lung>left</Lung>
                <Confidence>0.7012706</Confidence>
                <SOPInstanceUID>1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013</SOPInstanceUID>
                <Category>1</Category>
                <Volume>10959.221</Volume>
                <Diameter>9.730626</Diameter>
                <X>51.242912</X>
                <Y>-32.231476</Y>
                <Z>-46.816082</Z>
                <ImageX>308.9677</ImageX>
                <ImageY>198.35522</ImageY>
                <ImageZ>198.35522</ImageZ>
            </Elements>
            <Report>肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。</Report>
        </Series>
    </LungNodule>
    <CACS>
        <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>
        <Score>4.83</Score>
    </CACS>
    <Covid>
        <NormalProbability>0.7230905</NormalProbability>
        <NewProbability>4.062644e-06</NewProbability>
        <LesionRatio>0.9387283236994219</LesionRatio>
        <OtherProbability>0.27690542</OtherProbability>
        <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>
    </Covid>
    <DetectRibFracture>
        <ResultURL>http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****</ResultURL>
        <Detections>
            <FractureId>2</FractureId>
            <FractureConfidence>0.7916667</FractureConfidence>
            <FractureCategory>1</FractureCategory>
            <FractureLocation>L4</FractureLocation>
            <FractureSegment>0</FractureSegment>
        </Detections>
    </DetectRibFracture>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "cffdd6be-361f-4193-bcdb-ef8de7b5d8b6",
  "Data" : {
    "LungNodule" : {
      "Series" : [ {
        "SeriesInstanceUid" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.179049373636438705059720603192",
        "Elements" : [ {
          "Lobe" : "up",
          "MeanValue" : 261.3759,
          "Lung" : "left",
          "Confidence" : 0.7012706,
          "SOPInstanceUID" : "1.3.6.1.4.1.14519.5.2.1.6279.6001.261151233960269013402330853013",
          "Category" : "1",
          "Volume" : 10959.221,
          "Diameter" : 9.730626,
          "X" : 51.242912,
          "Y" : -32.231476,
          "Z" : -46.816082,
          "ImageX" : 308.9677,
          "ImageY" : 198.35522,
          "ImageZ" : 198.35522
        } ],
        "Origin" : [ ],
        "Report" : "肺部见1个实性结节,直径约为25.60mm,体积为11512.06mm³,平均CT值为-6.90HU。",
        "Spacing" : [ ]
      } ]
    },
    "CACS" : {
      "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****",
      "Score" : "4.83"
    },
    "Covid" : {
      "NormalProbability" : "0.7230905",
      "NewProbability" : "4.062644e-06",
      "LesionRatio" : "0.9387283236994219",
      "OtherProbability" : "0.27690542",
      "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****"
    },
    "DetectRibFracture" : {
      "ResultURL" : "http://vibktprfx-prod-prod-aic-med-cn-shanghai.oss-cn-shanghai.aliyuncs.com/detect-rib-fracture/local_test/2020-12-22/result-D5CD101C-F8E5-43CA-9E99-44C783B8F8BE.tar.gz?Expires=1608631727&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=d6c32E1IB4b7Ayo1lpjs%2Bq3Ylv****",
      "Spacing" : [ ],
      "Origin" : [ ],
      "Detections" : [ {
        "FractureId" : 2,
        "FractureConfidence" : 0.7916667,
        "FractureCategory" : 1,
        "Coordinates" : [ ],
        "CoordinateImage" : [ ],
        "FractureLocation" : "L4",
        "FractureSegment" : 0
      } ]
    }
  }
}

查询任务结果

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

错误码

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

SDK参考

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

安全声明

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