ScreenChestCT_视觉智能开放平台-图像分析处理_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

胸部 CT 平扫筛查能力基于常规胸部 CT 影像,实现了人体胸部多器官及多病种的检测及量化分析,主要功能如下:

  • 基于常规胸部 CT 自动测量冠状动脉的钙化积分值。
  • 自动检出肺结节,输出结节体积、平均灰度和 AI 结构化报告。
  • 自动分割肺叶区域肺炎病灶,输出病灶的大小和肺炎的类型等信息。
  • 检出肋骨骨折,并给出骨折的类型。
  • 可检测胸部平扫或增强 CT 中的肿大淋巴结,包含胸部的纵膈、肺门和锁骨上淋巴结。
  • 根据输入的胸部平扫 CT 评估胰腺癌风险。
说明 您可以进入在线咨询获取在线人工帮助。阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

胸部 CT 平扫筛查与医疗影像应用集成后,面向医院、区域医共体医联体、体检机构以及第三方影像中心等机构的影像医生、临床医生提供常规胸部 CT 影像检测及量化分析。

特色优势

功能丰富,首次实现通过一次 CT 扫描和一次上传即可完成多器官和多病种的检测和量化分析。

接入指引

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

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

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

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

  5. 开发接入:能力支持 SDK 方式调用,您可以选择合适的开发语言进行接入,具体操作,请参见 SDK 总览

  6. 示例代码:该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

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

输入限制

  • 图像格式:DICOM。
  • 图像大小:不超过 3 MB。
  • 图像分辨率:小于等于 512×512 像素。
  • 图像帧数:至少 20 帧,至多 1600 帧。
  • URL 地址中不能包含中文字符。

调用步骤

该能力为异步能力,需分两步进行调用。 第一步调用 ScreenChestCT 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。

计费说明

关于胸部 CT 平扫筛查的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
viapi-imageprocess:ScreenChestCT
None
全部资源
*

请求参数

字段名称字段详情
DataFormatstring

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

示例值:DICOM
OrgNamestring

数据来源机构名称。

示例值:weiyi
OrgIdstring

数据来源机构代码。

示例值:7ff51bfe-e73d-11ea-827d-506b4b3f3cf6
URLListarray<object>

DICOM 序列的地址列表。

子级条数 <= 1600
Maskinteger<int64>

该值控制输出算法输出的种类。十进制数。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:4
Verboseinteger<int64>

是否在返回参数中输出相关字段,取值 0、1 和 2,默认为 0。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:0

请求说明

算法启用与 Mask 值对应关系

Mask对应二进制数二进制中对应位置(由低到高位)描述
111二进制第一 bit 位为 1,代表启用新冠病毒肺炎辅助诊断算法。
2102二进制第二 bit 位为 1,代表启用冠脉钙化积分测算算法。
41003二进制第三 bit 位为 1,代表启用胸部 CT 肺结节检测算法。
810004二进制第四 bit 位为 1,代表启用肋骨骨折检测算法。
16100005二进制第五 bit 位为 1,代表启用主动脉瘤肺动脉高压检测算法。
321000006二进制第六 bit 位为 1,代表启用淋巴结检测算法。
6410000007二进制第七 bit 位为 1,代表启用胰腺癌检测算法。
128100000008二进制第八 bit 位为 1,代表启用食管癌检测算法。
25600000001000000009二进制第九 bit 位为 1,代表启用骨密度估计算法。
512000000100000000010二进制第十 bit 位为 1,代表启用脂肪肝检测算法。
1024000001000000000011二进制第十一 bit 位为 1,代表启用胃癌检测算法。
2048000010000000000012二进制第十二 bit 位为 1,代表启用结直肠癌检测算法。
4096000100000000000013二进制第十三 bit 位为 1,代表启用肝癌检测算法。
8192001000000000000014二进制第十四 bit 位为 1,代表启用 CVD 心血管不良事件检测算法。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:528B54D4-3AAB-47CF-B6CE-0C2A2FB4C7C2
Dataobject

返回的结果数据内容。该数据需要在异步任务执行成功后,通过调用 GetAsyncJobResult 接口,对其 Result 字段进行 JSON 反序列化之后得到。

Messagestring

提交异步任务后的提示信息。

示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

返回说明

查询结果

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

SDK 参考

阿里云视觉 AI 能力推荐使用 SDK 调用,支持多种编程语言,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

示例代码

该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
ParameterError
The parameter is invalid. Please check again.诊断
403
AuthFailed
An error occurred while performing authorization. Please check your RAM configuration.诊断
408
Timeout
The request has timed out.诊断
503
ServiceUnavailable
The service is unavailable.诊断

变更历史

变更时间变更内容概要操作
2025-03-25
变更返回参数
2025-03-18
变更返回参数
2025-03-11
变更返回参数
2025-03-03
变更返回参数
2025-02-20
变更返回参数
2024-12-10
变更返回参数
2024-12-10
变更返回参数
2024-10-06
变更返回参数
2023-05-30
变更返回参数
2023-05-25
变更返回参数

相关示例