本文介紹圖像分析處理(imageprocess)類目下的醫學智能問答RunMedQA的語法及示例。
功能描述
醫學智能問答能力面向皮膚病預問診場景,通過多輪對話和圖像收集的方式,完成皮膚病相關的預問診信息收集,并輸出結構化的預問診報告,預測潛在皮膚病。采集的問診信息主要包括以下內容:
- 基本信息,如主訴、年齡、部位等。
- 病情,如癥狀、并發癥、病程等。
- 病史相關,如疾病史、用藥史、過敏史等。
- 非結構化信息,如皮損圖片等。
- 您可以進入在線咨詢獲取在線人工幫助。
- 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
應用場景
面向皮膚病預問診場景,采用多輪對話的方式,完成問診信息采集。
特色優勢
- 會話流程簡潔、智能,便于集成到用戶應用中。
- 問診信息抽取能力準確高效,結合多模態皮膚病預測技術,自動化生成病例報告和潛在疾病診斷,可有效降低問診時間成本。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通圖像分析處理,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為圖像分析處理(imageprocess)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:JPEG、JPG、PNG、BMP。
- 圖像大小:不超過3 MB。
- 圖像分辨率:大于256×256像素,小于2048×2048像素。
- URL地址中不能包含中文字符。
- 問題內容字數不能超過500字。
計費說明
醫學智能問答能力目前處于公測期,可免費調用。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | RunMedQA | 系統規定參數。取值:RunMedQA。 |
OrgId | String | 是 | 0001 | 數據來源機構代碼。 |
OrgName | String | 是 | weiyi | 數據來源機構名稱。 |
SessionId | String | 否 | d1f6a6c2444f4c01adfadd413938e5c7 | 會話ID。首次發送主訴信息時無需填寫SessionId,當QuestionType為 說明 一次問診對應一個SessionId,一次問診會有多輪次對話,每個輪次都對應當前這個問診的唯一SessionId。問診有效期為24小時,24小時后SessionId失效。 |
Department | String | 是 | 皮膚科 | 代表醫院科室。 說明 當前服務版本僅支持皮膚科。 |
QuestionType | String | 是 | chiefComplaint | 問題類型。取值如下:
說明 首次問診,QuestionType不能為空,且必須為 images 類型,sessionId可為空。 |
AnswerImageURLList.N.AnswerImageURL | String | 否 | https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imageprocess/roseola.jpeg | 待檢測皮膚病圖像的URL地址。最多支持添加50條。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 說明 當QuestionType為 images 時必填。AnswerImageURL和AnswerImageData建議二選一,當與Base64編碼方式共存時,URL方式優先。文件的Base64編碼處理操作,請參見文件Base64處理。 |
AnswerImageDataList.N.AnswerImageData | String | 否 | iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb**** | 待檢測皮膚病圖像的Base64編碼字符串。最多支持添加50條。文件的Base64編碼處理操作,請參見文件Base64處理。 說明 當QuestionType為 images 時必填。AnswerImageURL和AnswerImageData建議二選一,當與URL方式共存時,URL方式優先。 |
AnswerTextList.N.AnswerText | String | 否 | 起了好多紅疙瘩流膿,癢死了,晚上癢的最厲害,怎么辦啊? | 患者的主訴或回答列表。最多支持添加50條。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | BFF7EEC3-F6B5-4387-AC1D-BB095A1A02E4 | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
SessionId | String | d1f6a6c2444f4c01adfadd413938e5c7 | 會話ID。 |
QuestionType | String | age | 問題類型。 |
Question | String | 你好,還需要你補充些其他信息,年齡多大了? | 補充追問問題。當QuestionType為 |
AnswerType | String | text | 選項類型。默認為text。
|
Options | Array of String | "發燒","呼吸困難","關節疼痛","腹瀉","頭痛","無" | 問題選項。 |
Reports | Map | 預問診信息結構化報表。當QuestionType為 |
|
String | "diagResults": [ "多形紅斑", "玫瑰糠疹", "急性蕁麻疹" ], "diagProb": { "多形紅斑": 0.992, "急性蕁麻疹": 0.0019, "玫瑰糠疹": 0.0053 } | 預問診信息結構化報表。 Reports中對應的key-value值如下表所示。 |
參數補充說明
key |
value類型 |
是否有返回值 |
中文描述 |
symptoms |
List<String> |
是 |
癥狀 |
complications |
List<String> |
是 |
并發癥 |
diseaseHistory |
List<String> |
是 |
疾病史 |
medications |
List<String> |
是 |
用藥史 |
allegries |
List<String> |
是 |
過敏史 |
bodyParts |
List<String> |
是 |
部位 |
diseaseCourse |
List<String> |
是 |
病程 |
age |
List<String> |
是 |
年齡 |
formDistribution |
List<String> |
否(非模板必須,算法抽取出的) |
形態分布 |
images |
List<String> |
是 |
圖片 |
diagResults |
List<String> |
是 |
診斷結果 |
diagProb |
Map |
是 |
診斷概率 |
bbox |
List<Obeject> |
是 |
病灶區域 |
SDK參考
阿里云視覺AI圖像分析處理類目下的醫學智能問答能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為圖像分析處理(imageprocess)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例
請求示例
http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=RunMedQA //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&OrgId=0001
&OrgName=weiyi
&SessionId=d1f6a6c2444f4c01adfadd413938e5c7
&Department=皮膚科
&QuestionType=chiefComplaint
&AnswerImageURLList=[{"AnswerImageURL":"https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imageprocess/roseola.jpeg"}]
&AnswerImageDataList=[{"AnswerImageData":"iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****"}]
&AnswerTextList=[{"AnswerText":"起了好多紅疙瘩流膿,癢死了,晚上癢的最厲害,怎么辦啊?"}]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RunMedQAResponse>
<RequestId>5AC38357-6B32-508E-A8AE-3BB891A6D2E8</RequestId>
<Data>
<QuestionType>chiefComplaint</QuestionType>
<Reports>
<bbox>
<score>0.8148</score>
<y1>1</y1>
<x1>20</x1>
<y2>355</y2>
<x2>534</x2>
</bbox>
<diagResults>多形紅斑</diagResults>
<diagResults>玫瑰糠疹</diagResults>
<diagResults>急性蕁麻疹</diagResults>
<diagProb>
<多形紅斑>0.992</多形紅斑>
<急性蕁麻疹>0.0019</急性蕁麻疹>
<玫瑰糠疹>0.0053</玫瑰糠疹>
</diagProb>
</Reports>
<Question>請描述一下您的病情?</Question>
<AnswerType>text</AnswerType>
<SessionId>7fa1fcaa9a5845d5906f5648d6de284f</SessionId>
</Data>
<Code/>
</RunMedQAResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "5AC38357-6B32-508E-A8AE-3BB891A6D2E8",
"Data" : {
"QuestionType" : "chiefComplaint",
"Reports" : {
"bbox" : {
"score" : 0.8148,
"y1" : 1,
"x1" : 20,
"y2" : 355,
"x2" : 534
},
"diagResults" : [ "多形紅斑", "玫瑰糠疹", "急性蕁麻疹" ],
"diagProb" : {
"多形紅斑" : 0.992,
"急性蕁麻疹" : 0.0019,
"玫瑰糠疹" : 0.0053
}
},
"Question" : "請描述一下您的病情?",
"AnswerType" : "text",
"SessionId" : "7fa1fcaa9a5845d5906f5648d6de284f"
},
"Code" : ""
}
錯誤碼
關于醫學智能問答的錯誤碼。詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。