本文介绍胸部CT肺结节检测DetectLungNodule的语法及示例。

功能描述

胸部CT肺结节检测可以对输入的胸部常规CT形成的DICOM影像（如5mm的单个序列，API仅接受单序列），进行肺结节的辅助诊断。针对每一个结节，主要通过以下方式进行描述：

  • 结节的坐标（coordX，coordY，coordZ）、直径（diameter_mm）。
  • 结节在肺叶的位置，例如左肺或右肺，以及肺叶分段（左肺上下叶、右肺上中下叶），通过lung和lobe两个参数共同确定。
  • 结节分类及概率。

前提条件

请确保您已开通图像分析处理，若未开通服务请立即开通。

输入限制

  • 影像格式：DICOM。
  • 影像分辨率：小于等于512×512像素。
  • 单张DICOM影像大小不超过1M。
  • 输入最少20张，最多600张。
  • URL中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DetectLungNodule

要执行的操作。取值：DetectLungNodule。
DataFormat String 是 DICOM

图片的格式：DICOM。
OrgId String 是 0001

数据来源机构代码。
OrgName String 是 weiyi

数据来源机构名称。
URLList.N.URL String 是 https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/LIDC-IDRI-0001/000001.dcm

DICOM影像的图像URL地址。长度小于600。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

Threshold Float 否 0.70

结点阈值。默认取值0.70，取值范围(0,1]，取值越低，输出结节越多，仅取小数点后两位。

返回数据

名称 类型 示例值 描述
Data 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 20.434030793471255

结节在图像坐标系中的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 9889ef5b-b973-4dd0-9f26-3b9cc489c436

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectLungNodule
&DataFormat=DICOM
&OrgId=0001
&OrgName=weiyi
&URLList.1.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/LIDC-IDRI-0001/000001.dcm
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>9889ef5b-b973-4dd0-9f26-3b9cc489c436</RequestId>
<Data>
    <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>20.434030793471255</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>
</Data>

JSON 格式 

{
    "RequestId": "9889ef5b-b973-4dd0-9f26-3b9cc489c436",
    "Data": {
        "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": 20.434030793471255,
                    "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]"
            }
        ]
    }
}

查询任务结果

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

错误码

关于胸部CT肺结节检测的错误码。详情请参见常见错误码。

SDK参考

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

安全声明

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