文档

腰椎MRI定性分析

更新时间:

本文介绍图像分析处理(imageprocess)类目下的腰椎MRI定性分析DetectSpineMRI的语法及实例。

服务说明

腰椎MRI定性分析(DetectSpineMRI)服务将于2024年4月24日起停止服务,后续不再支持新老用户开通接入及调用服务。如果您在使用过程中有疑问,可通过搜索钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

功能描述

腰椎MRI定性分析能力可以对输入的脊柱或腰椎部分的核磁DICOM影像进行智能分析,输出椎间盘和锥体信息。

成人脊柱的椎骨(24块)构成:

  • 颈椎(Cervical vertebrae) 共计7块,命名C1,...,C7。
  • 胸椎(Thoracic vertebrae) 共计12块,命名T1,...,T12。
  • 腰椎(Lumbar vertebrae) 共计5块,命名L1,...,L5。

成人脊柱除椎骨外,还有骶椎(Sacral vertebrae) 共计1块(命名S1)、尾椎(Coccygeal vertebrae) 共计1块。

计入与骶椎的椎间盘,椎间盘共计24个,标识椎间盘可以通过C1-C2来标识自上而下的第一个椎间盘,L5-S1标识自下而上的第一个椎间盘。

椎间盘疾病标识:

  • 正常(Normal),以v1标识。
  • 退行性改变(Degeneration),以v2标识。
  • 弥散型膨出(Circumferential Bulge),以v3标识。
  • 非对称性膨出(Asymmetric Bulge),以v4标识。
  • 突出(Protruded),以v5标识。
  • 脱出(Extruded),以v6标识。
  • 疝出(Schmorl),以v7标识。
  • 其他类型(Other),以v8标识。

椎体标识:

  • 正常(Normal),以v1标识。
  • 退行性改变(Degeneration),以v2标识。
  • 其他类型(Other),以v3标识。
说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通图像分析处理,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入步骤:

  • SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为图像分析处理(imageprocess)的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

输入限制

  • 图像格式:DICOM。
  • 图像帧数:至少20帧,至多300帧。
  • URL地址中不能包含中文字符。

计费说明

腰椎MRI定性分析能力目前处于公测期,可免费调用。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DetectSpineMRI

系统规定参数。取值:DetectSpineMRI

DataFormat String DICOM

图像的格式:DICOM。

OrgName String weiyi

数据来源机构名称。

OrgId String 0001

数据来源机构代码。

URLList.N.URL String https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/spine-mri/00bY9Fa67NR3/1.3.12.2.1107.5.2.30.27581.2018051110083199050615391.dcm

DICOM序列的URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理

说明 URLList.N.URL中的N为该图像URL在当前List中的顺序(从1开始)。当直接使用API请求时,输入URLList的填充会以URLList.1.URL=url1,URLList.2.URL=url2,......的方式指定参数和参数值,参数对以&连接,其中url1、url2、......等具体值请根据实际情况进行替换;当使用SDK填充URLList时,可直接使用SDK提供的相应的方法。

返回数据

名称

类型

示例值

描述

RequestId String 3bddad65-c0d8-4758-86cf-9136c20a11f3

请求ID。

Data Object

返回的结果数据内容。

Discs Array of Disc

椎间盘结果数据。

Identification String L5-S1

椎间盘位置。

Disease String v1

疾病标识。

Location Array of Float [527,268]

椎间盘和锥体在影像上的像素点坐标。

Vertebras Array of Vertebra

锥体结果描述。

Identification String L5

椎体位置。

Disease String v2

疾病标识。

Location Array of Float [488,258]

椎间盘和锥体在影像上的像素点坐标。

SDK参考

阿里云视觉AI图像分析处理类目下的腰椎MRI定性分析能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为图像分析处理(imageprocess)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览

示例

请求示例

http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectSpineMRI      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&DataFormat=DICOM
&OrgId=0001
&OrgName=weiyi
&URLList.1.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/0001.dcm
&URLList.2.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/0002.dcm
&<公共请求参数>

正常返回示例

XML格式

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

<DetectSpineMRIResponse>
    <data>
        <discs>
            <disease>v1</disease>
            <identification>L5-S1</identification>
            <location>527</location>
            <location>268</location>
        </discs>
        <discs>
            <disease>v2,v3</disease>
            <identification>L4-L5</identification>
            <location>447</location>
            <location>254</location>
        </discs>
        <discs>
            <disease>v1</disease>
            <identification>L3-L4</identification>
            <location>365</location>
            <location>259</location>
        </discs>
        <discs>
            <disease>v2,v3</disease>
            <identification>L2-L3</identification>
            <location>285</location>
            <location>272</location>
        </discs>
        <discs>
            <disease>v2,v3</disease>
            <identification>L1-L2</identification>
            <location>210</location>
            <location>289</location>
        </discs>
        <discs>
            <disease>v1</disease>
            <identification>T12-L1</identification>
            <location>135</location>
            <location>296</location>
        </discs>
        <discs>
            <disease>v1</disease>
            <identification>T11-T12</identification>
            <location>65</location>
            <location>306</location>
        </discs>
        <vertebras>
            <disease>v2</disease>
            <identification>L5</identification>
            <location>488</location>
            <location>258</location>
        </vertebras>
        <vertebras>
            <disease>v2</disease>
            <identification>L4</identification>
            <location>406</location>
            <location>254</location>
        </vertebras>
        <vertebras>
            <disease>v2</disease>
            <identification>L3</identification>
            <location>325</location>
            <location>263</location>
        </vertebras>
        <vertebras>
            <disease>v2</disease>
            <identification>L2</identification>
            <location>246</location>
            <location>279</location>
        </vertebras>
        <vertebras>
            <disease>v2</disease>
            <identification>L1</identification>
            <location>172</location>
            <location>291</location>
        </vertebras>
    </data>
    <httpCode>200</httpCode>
    <requestId>3bddad65-c0d8-4758-86cf-9136c20a11f3</requestId>
    <success>true</success>
</DetectSpineMRIResponse>

JSON格式

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

{
  "data" : {
    "discs" : [ {
      "disease" : "v1",
      "identification" : "L5-S1",
      "location" : [ 527, 268 ]
    }, {
      "disease" : "v2,v3",
      "identification" : "L4-L5",
      "location" : [ 447, 254 ]
    }, {
      "disease" : "v1",
      "identification" : "L3-L4",
      "location" : [ 365, 259 ]
    }, {
      "disease" : "v2,v3",
      "identification" : "L2-L3",
      "location" : [ 285, 272 ]
    }, {
      "disease" : "v2,v3",
      "identification" : "L1-L2",
      "location" : [ 210, 289 ]
    }, {
      "disease" : "v1",
      "identification" : "T12-L1",
      "location" : [ 135, 296 ]
    }, {
      "disease" : "v1",
      "identification" : "T11-T12",
      "location" : [ 65, 306 ]
    } ],
    "vertebras" : [ {
      "disease" : "v2",
      "identification" : "L5",
      "location" : [ 488, 258 ]
    }, {
      "disease" : "v2",
      "identification" : "L4",
      "location" : [ 406, 254 ]
    }, {
      "disease" : "v2",
      "identification" : "L3",
      "location" : [ 325, 263 ]
    }, {
      "disease" : "v2",
      "identification" : "L2",
      "location" : [ 246, 279 ]
    }, {
      "disease" : "v2",
      "identification" : "L1",
      "location" : [ 172, 291 ]
    } ]
  },
  "httpCode" : 200,
  "requestId" : "3bddad65-c0d8-4758-86cf-9136c20a11f3",
  "success" : true
}

错误码

关于腰椎MRI定性分析的错误码。详情请参见常见错误码

安全声明

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

  • 本页导读 (1)
文档反馈