ai面診ai手診ai舌診辨證面診api手診辨證api接口概述
舌診辨證面診手診接口提供中醫(yī)智能舌面診、體質(zhì)檢測及健康報告生成服務(wù)。通過上傳舌象、面象圖片,結(jié)合交互式問診,AI可精準辨證,輸出個性化體質(zhì)分析與調(diào)理建議。
基本信息
認證方式:需實名認證并獲取API密鑰
接口地址:/api/ai/tonguediagnosis
請求方式:HTTP GET/POST
請求頭:Content-Type: application/x-www-form-urlencoded;charset=utf-8
請求參數(shù)
參數(shù)名? 必填? 類型? 示例值? 說明
key? 是? string? 35kj5jnlj53453kl5j43nj5? 接口密鑰(控制臺獲?。?/p>
action? 是? string? diagnose? 操作類型:diagnose(首次診斷)、report(提交答案)
tf_image? 三選一? string? /tongue.jpg? 舌面圖片URL
ff_image? 三選一? string? /face.jpg? 面部圖片URL
tb_image? 三選一? string? /tongue_bottom.jpg? 舌下脈絡(luò)圖片URL
scene? 否? int? 1? 場景模式:1-問答推斷(推薦),2-直接生成報告
gender? 否? string? 男? 用戶性別:男/女
返回參數(shù)
參數(shù)名? 類型? 說明
code? int? 狀態(tài)碼(200成功,201需補充問診,400參數(shù)錯誤,500系統(tǒng)異常)
msg? string? 狀態(tài)信息
data? object? 結(jié)果數(shù)據(jù)集
session_id? string? 會話ID(用于續(xù)傳問診)
inquiry_questions? array? 問診問題列表(僅當scene=1時返回)
exec_time? float? 執(zhí)行耗時(秒)
user_ip? string? 客戶端IP
返回示例
首次診斷請求(action=diagnose)
{
? "code": 201,
? "msg": "請回答以下問診問題以獲取完整報告",
? "data": {
? ? "session_id": "6a6137ee-42ab-11f1-90a7-00163e2e82b2",
? ? "inquiry_questions": [
? ? ? {"name": "頭面斑", "value": "7f4ceedf-ac16-4f24-9bb6-42d89dc8b3f4"},
? ? ? {"name": "面色晦暗", "value": "6c097f16-31b8-49f3-8988-f929d16fbf14"},
? ? ? {"name": "唇暗", "value": "aa53c3d2-1ba5-41d9-9504-b0793a0a58a8"}
? ? ]
? },
? "exec_time": 8.82,
? "user_ip": "47.98.207.7"
}
提交問診答案請求(action=report)
{
? "action": "report",
? "session_id": "3ab1170c-42b1-11f1-90d6-00163e2ec1d4",
? "answers": [
? ? {"name": "口黏", "value": "6e0218aa-8785-4202-81ff-228e13cb7b37", "answer": "是"},
? ? {"name": "口苦", "value": "1ac38456-1ffc-43ec-a9f0-dc0d4bc09ce4", "answer": "是"},
? ? {"name": "口臭", "value": "da76c79a-d6b0-438c-a924-8df79ff46a0f", "answer": "是"}
? ]
}
錯誤碼說明
錯誤碼? 說明
200? 請求成功
201? 需補充問診信息
400? 參數(shù)缺失或格式錯誤
401? 密鑰無效或過期
429? 請求頻率超限
500? 服務(wù)器內(nèi)部錯誤
使用流程
首次診斷:上傳舌/面圖片,設(shè)置action=diagnose。
交互式問診:若返回code=201,根據(jù)inquiry_questions引導(dǎo)用戶回答問題。
提交答案:將答案按action=report格式提交,攜帶session_id。
獲取報告:系統(tǒng)返回完整辨證結(jié)果,包含體質(zhì)類型、調(diào)理建議等。
注意事項
圖片需為清晰正面照,避免強光或遮擋。
tf_image、ff_image、tb_image至少提供一個。
會話ID有效期為30分鐘,超時需重新診斷。
來源:酷虎云api開放平臺