本文介绍图像分析处理(imageprocess)类目下的腰椎MRI定性分析DetectSpineMRI的语法及实例。
功能描述
腰椎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地址中不能包含中文字符。
调试
您可以在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小时后会被系统自动清理删除。