接口说明
功能描述
放疗淋巴站分割能力可以根据输入的胸部平扫或增强 CT,指定目标部位,进行淋巴站分割。其中,目标部位为胸部(CHEST),最终以 NIFTI 格式 mask 的形式给出淋巴站分割的结果。
- 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
应用场景
体检筛查:支持输入胸部平扫 CT 评估肠癌风险,可输出分类结果和病灶分割结果。
特色优势
- 肠癌风险评估:输出正常肠、肠癌、非肠癌病变的三分类概率,其中三者中最高的一项为分类结果。
- 病灶可视化:输出正常肠、肠癌、非肠癌病变的体积及对应的分割结果(以 NIFTI 文件标识)。
接入指引
- 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
- 开通能力:请确保您已开通图像分析处理,若未开通服务请立即开通。
- 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权。
- 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
- 开发接入步骤:
- 在 SDK 总览中选择您要接入使用的 SDK 语言。
- 在对应语言的 SDK 文档中找到 AI 类目为图像分析处理(imageprocess)的 SDK 包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
-
示例代码:该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码。
-
客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
URLList 长度大于 20 且小于 600(即每个序列的 slice 张数最少 20 张,最大支持 600 张),每个 URL 需通过 HTTP 协议可访问。
调用步骤
该能力为异步能力,需分两步进行调用。 第一步调用 SegmentLymphNode 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。
计费说明
放疗淋巴站分割能力目前处于公测期,可免费调用。
流控信息
请求参数
字段名称 | 字段详情 |
---|---|
URLListarray<object> | 图像 URL 列表。 子级条数 <= 600子级条数 >= 20 |
DataFormatstring | 图片的格式。支持 DICOM 或 NIFTI。 示例值:DICOM |
BodyPartstring | 期望输出的危及器官所在的身体部位。当前版本只支持 CHEST。展开详情 示例值:CHEST |
OrgIdstring | 当前渠道(即主账号)下的子渠道(即机构,如医院)标识。 示例值:1 |
OrgNamestring | 当前渠道(即主账号)下的子渠道(即机构,如医院)名称。 示例值:1 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID。 示例值:B48DECE6-29FE-1967-92F1-2E072873851A |
Dataobject | 该数据需要在异步任务执行成功后,通过调用 GetAsyncJobResult 接口,对其 Result 字段进行 JSON 反序列化之后得到。 |
Messagestring | 提交异步任务后的提示信息。 示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。 |
返回说明
查询结果
该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult 。
SDK 参考
阿里云视觉 AI 图像分析处理类目下的放疗淋巴站分割能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为图像分析处理(imageprocess)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览。
示例代码
该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码。