本文介绍图像分析处理（imageprocess）类目下的新冠病毒肺炎辅助诊断DetectCovid19Cad的语法及示例。
功能描述
新冠病毒肺炎辅助诊断能力可以对输入的DICOM影像（如5mm的单个序列），进行新冠肺炎的影像分析。可以输出：
- 新冠肺炎、普通肺炎与其他的概率。
- 白化比例测算值。
- 病灶位置的mask文件。
接入指引
1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
2. 开通能力：请确保您已开通图像分析处理，若未开通服务请立即开通。
3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。
4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。
5. 开发接入步骤：
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为图像分析处理（imageprocess）的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码：该能力常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。
7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。
输入限制
- 输入图像必须为横断面图像。
- 图像格式：DICOM。
- 图像帧数：至少20帧，至多2048帧，且必须为单人单次检查单次扫描的整套series序列。
- URL地址中不能包含中文字符。
计费说明
关于新冠病毒肺炎辅助诊断的计费方式及报价，请参见计费介绍。
调用步骤
该能力为异步能力，需分以下几步进行调用。
第一步调用DetectCovid19Cad接口提交任务，请求成功后，得到一个任务ID。
第二步调用GetAsyncJobResult接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DetectCovid19Cad | 系统规定参数。取值：DetectCovid19Cad。 |
| DataFormat | String | 是 | DICOM | 图片的格式：DICOM。 |
| OrgName | String | 是 | weiyi | 数据来源机构名称。 |
| OrgId | String | 是 | 0001 | 数据来源机构代码。 |
| URLList.N.URL | String | 是 | https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/CT0001.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 | 7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4 | 请求ID。 |
| Data | Object | 返回的结果数据内容。 该数据需要在异步任务执行成功后，通过调用GetAsyncJobResult接口，对其Result字段进行JSON反序列化之后得到。 |
|
| NormalProbability | String | 0.7230905 | 普通肺炎的概率。 |
| NewProbability | String | 4.062644e-06 | 新冠肺炎概率。 |
| LesionRatio | String | 0.9387283236994219 | 白化比例。 |
| OtherProbability | String | 0.27690542 | 其他概率。 |
| Mask | String | http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF**** | NII格式的mask文件HTTP地址。 说明 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。 |
| Message | String | 该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。 | 提交异步任务后的提示信息。 |
查询结果
该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见GetAsyncJobResult。
SDK参考
阿里云视觉AI图像分析处理类目下的新冠病毒肺炎辅助诊断能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像分析处理（imageprocess）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。
示例代码
该能力常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。
示例
请求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectCovid19Cad //更多关于访问域名（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/CT0001.dcm
&URLList.2.URL=https://medclients-sh.oss-cn-shanghai.aliyuncs.com/demo/xxx/CT0002.dcm
&<公共请求参数>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectCovid19CadResponse>
<RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>
<Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>
</DetectCovid19CadResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4",
"Message" : "该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。"
}返回示例补充说明
//查询结果：请求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectCovid19Cad
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共请求参数>
//查询结果：返回示例
{
"RequestId" : "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
"Data" : {
"Status" : "PROCESS_SUCCESS",
"JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
"Result" : "{\"NormalProbability\":\"0.7230905
\",\"NewProbability\":\"4.062644e-06
\",\"LesionRatio\":\"0.9387283236994219\",\"OtherProbability\":\"0.27690542\",\"Mask\":\"http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****\"}"
}
}
//Result反序列化
{
"NormalProbability" : "0.7230905",
"NewProbability" : "4.062644e-06 ",
"LesionRatio" : "0.9387283236994219",
"OtherProbability" : "0.27690542 ",
"Mask" : "http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****",
}错误码
关于新冠病毒肺炎辅助诊断的错误码。详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。