本文介绍图像分析处理(imageprocess)类目下的皮肤病检测DetectSkinDisease的语法及示例。
功能描述
皮肤病检测能力可以对输入的皮肤自然图像进行皮肤病分类预测。
接入指引
1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
2. 开通能力:请确保您已开通图像分析处理,若未开通服务请立即开通。
3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权。
4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。
5. 开发接入步骤:
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为图像分析处理(imageprocess)的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:JPG、PNG。
- 图像大小:不超过20 MB。
- 图像分辨率:小于1280×1280像素。
- URL地址中不能包含中文字符。
计费说明
皮肤病检测能力目前处于公测期,可免费调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DetectSkinDisease | 系统规定参数。取值:DetectSkinDisease。 |
Url | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageprocess/DetectSkinDisease/DetectSkinDisease1.png | 图像的URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理。 |
OrgId | String | 是 | 0001 | 数据来源机构代码。 |
OrgName | String | 是 | demo | 数据来源机构名称。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | DE9ABC80-4DD4-4F1B-B95C-D0E438B8FE56 | 请求ID。 |
Data | Object | 返回的结果数据内容。 |
|
Results | Map | 预测的结果。包含Key-Value对,Key为疾病名称,Value为概率。目前支持以下49类,具体分类如下表所示。 |
|
ResultsEnglish | Map | 预测结果对应的英文。 |
|
BodyPart | String | leg | 皮损部位识别。取值如下:
|
ImageQuality | Float | 90.9812 | 图像质量评分。 |
ImageType | String | skin_lesion | 图像分类。取值如下:
|
皮肤病分类
序号 |
皮肤病分类(中文) |
皮肤病分类(英文) |
序号 |
皮肤病分类(中文) |
皮肤病分类(英文) |
1 |
痤疮 |
acne |
26 |
玫瑰糠疹 |
pityriasis_rosea |
2 |
光化性角化病 |
actinic_keratosis |
27 |
结节性痒疹 |
prurigo_nodularis |
3 |
脂溢性脱发 |
alopecia_androgenetica |
28 |
银屑病 |
psoriasis |
4 |
斑秃 |
alopecia_areata |
29 |
玫瑰痤疮 |
rosacea |
5 |
大疱性皮肤病 |
bullous_dermatosis |
30 |
皮脂腺囊肿 |
sebaceous_cyst |
6 |
黄褐斑 |
chloasma |
31 |
皮脂腺痣 |
sebaceousnevus |
7 |
鸡眼 |
corn |
32 |
脂溢性皮炎 |
seborrheic_dermatitis |
8 |
皮肤纤维瘤 |
dermatofibroma |
33 |
脂溢性角化 |
seborrheic_keratosis |
9 |
皮炎湿疹 |
eczema_dermatitis |
34 |
皮赘 |
skin_tag |
10 |
丹毒 |
erysipelas |
35 |
淤积性皮炎 |
stasis_dermatitis |
11 |
多形红斑 |
erythema_multiforme |
36 |
汗管瘤 |
syringoma |
12 |
毛囊炎 |
folliculitis |
37 |
头癣 |
tinea_capitis |
13 |
疖 |
furuncle |
38 |
体癣 |
tinea_corporis |
14 |
血管瘤 |
haemangioma |
39 |
股癣 |
tinea_cruris |
15 |
带状疱疹 |
herpes |
40 |
手癣 |
tinea_manuum |
16 |
单纯疱疹 |
herpes_simplex |
41 |
脚癣 |
tinea_pedis |
17 |
过敏性紫癜 |
iga_vasculitis |
42 |
甲癣 |
tinea_unguium |
18 |
瘢痕疙瘩 |
keloid |
43 |
花斑癣 |
tinea_versicolor |
19 |
毛周角化症 |
keratosis_follicularism |
44 |
荨麻疹 |
urticaria |
20 |
扁平苔藓 |
lichen_planus |
45 |
丘疹性荨麻疹 |
urticaria_papular |
21 |
皮肤型红斑狼疮 |
lupus_erythematosus |
46 |
水痘 |
varicella |
22 |
传染性软疣 |
molluscum_contagiosum |
47 |
扁平疣 |
verruca_plana |
23 |
色素痣 |
nevus |
48 |
寻常疣 |
verruca_vulgaris |
24 |
甲沟炎 |
paronychia |
49 |
白癜风 |
vitiligo |
25 |
白色糠疹 |
pityriasis_alba |
SDK参考
阿里云视觉AI图像分析处理类目下的皮肤病检测能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为图像分析处理(imageprocess)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例
请求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectSkinDisease //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&Url=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageprocess/DetectSkinDisease/DetectSkinDisease1.png
&OrgId=0001
&OrgName=demo
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectSkinDiseaseResponse>
<RequestId>DE9ABC80-4DD4-4F1B-B95C-D0E438B8FE56</RequestId>
<Data>
<BodyPart>leg</BodyPart>
<ImageQuality>90.9812</ImageQuality>
<ImageType>normal_skin</ImageType>
</Data>
</DetectSkinDiseaseResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "DE9ABC80-4DD4-4F1B-B95C-D0E438B8FE56",
"Data" : {
"ImageQuality" : 90.9812,
"BodyPart" : "leg",
"Results" : {
"银屑病" : 0.998,
"皮肤型红斑狼疮" : 4.0E-4,
"皮炎湿疹" : 0.0011
},
"ResultsEnglish" : {
"psoriasis" : 0.998,
"eczema_dermatitis" : 0.0011,
"lupus_erythematosus" : 4.0E-4
},
"ImageType" : "skin_lesion"
}
}
错误码
关于皮肤病检测的错误码。详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。