开发中：该算法尚未接入线上服务，现阶段调用会返回演示数据（响应中带
_demo: true 标识，且不计费用）。
接口路径、参数与返回字段已按最终规范确定，可以先按文档完成对接，正式上线后无需改动任何代码。
如需提前试用或了解上线计划，请联系我们。
整合队列研究数据与真实世界体检数据构建的慢病风险预测模型，输入常规体检项目与生活方式问卷即可输出多病种的 3 年/5 年发病概率与风险等级。
模型同时给出各风险因子的贡献度排序，并生成可执行的干预建议，适合作为体检报告解读、健康管理方案生成的基础能力。
能力特点
- 缺失值容错，核心指标缺失时自动降级到可用模型变体
- 输出因子贡献度，便于生成解释性话术
- 支持自定义风险分层阈值
适用场景
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
age | int | 是 | 年龄（岁） |
gender | string | 是 | male / female |
bmi | float | 否 | 体质指数 kg/m² |
indicators | object | 否 | 体检指标键值对，如 fasting_glucose、systolic_bp |
lifestyle | object | 否 | 生活方式：smoking、drinking、exercise_freq |
horizon | int | 否 | 预测年限：3 或 5，默认 5 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.overall_score | int | 综合健康分 0~100，越高越好 |
data.risk_level | string | low / medium / medium_high / high |
data.risks[].score | int | 单病种风险分 0~100，越高风险越大 |
data.risks[].top_factors | array | 主要贡献因子 |
data.recommendations | array | 干预建议列表 |
错误码
| code | HTTP | 含义 | 处理建议 |
|---|---|---|---|
0 | 200 | 成功 | 请求正常处理完成。 |
40101 | 401 | 缺少鉴权 | 请求头未携带 Authorization，请检查 Bearer Token。 |
40102 | 401 | Key 无效 | API Key 不存在或已被吊销，请到控制台确认。 |
40103 | 403 | 算法未开通 | 当前 Key 未开通该算法，请先在控制台申请权限。 |
40104 | 403 | 来源不合法 | 云函数侧内部凭证校验失败，请经门户网关调用，勿直连算法后端。 |
40105 | 503 | 后端未校验 | 算法后端未通过内部凭证校验，网关已拒绝转发，需管理员在算法运维页重新校验。 |
42901 | 429 | 超出配额 | 当日调用量已达上限，可升级套餐或次日重试。 |
42201 | 422 | 参数错误 | 必填参数缺失或类型不正确，见 detail 字段。 |
50001 | 502 | 算法后端异常 | 上游算法执行失败，request_id 可用于排查。 |
50002 | 504 | 算法超时 | 单次请求超过 30 秒，请缩小输入后重试。 |
request.json
{
"age": 46,
"gender": "male",
"bmi": 26.8,
"indicators": {
"fasting_glucose": 7.1,
"systolic_bp": 138,
"hdl": 0.9
},
"lifestyle": {
"smoking": true,
"exercise_freq": 1
}
}
response.json · 演示数据
{
"request_id": "req_5b8e4f10d2",
"code": 0,
"message": "success",
"data": {
"overall_score": 72,
"risk_level": "medium_high",
"risks": [
{
"name": "2 型糖尿病",
"score": 78,
"level": "high",
"top_factors": [
"空腹血糖偏高",
"BMI 超标"
]
},
{
"name": "高血压",
"score": 61,
"level": "medium",
"top_factors": [
"收缩压临界",
"家族史"
]
},
{
"name": "脂肪肝",
"score": 45,
"level": "low",
"top_factors": [
"谷丙转氨酶轻度升高"
]
}
],
"recommendations": [
"建议 3 个月后复查空腹血糖与糖化血红蛋白",
"控制每日热量摄入，每周中等强度运动 ≥150 分钟",
"减少精制碳水与含糖饮料摄入"
],
"latency_ms": 158
}
}
指标表现
C-index0.83
覆盖病种8 类
单次响应< 300ms