PPG 高阶版 API

PPG高阶版提供基于ECG+PPG融合分析的血压估算和血管健康评估功能。

订阅要求

PPG高阶版API需要高阶版订阅。查看定价

数据要求

PPG高阶分析需要同时提供ECG和PPG数据，以提高分析准确性。

血压估算

POST /api/v1/advanced/ppg/blood-pressure

基于ECG和PPG信号的融合分析，估算血压值（收缩压和舒张压）。

重要说明

血压估算为辅助参考，不能替代医用血压计测量。不作为医学诊断依据。

请求参数

参数	类型	必填	说明
ecgData	array	✅	ECG信号数据数组
ecgSampleRate	number	✅	ECG采样率，单位Hz
adcGain	number	❌	增益系数，默认1.0
adcZero	number	❌	零点电压，默认0.0
ppgData	object	✅	PPG信号数据对象
ppgSampleRate	number	✅	PPG采样率，单位Hz

ppgData 对象结构

字段	类型	必填	说明
red	array	✅	红光PPG数据数组
green	array	✅	绿光PPG数据数组
infrared	array	✅	红外光PPG数据数组

PPG三通道数据

需要同时提供红光、绿光、红外三个通道的PPG数据，用于提高血压估算的准确性。

请求示例

curl -X POST "https://api.heartvoice.com.cn/api/v1/advanced/ppg/blood-pressure" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ecgData": [512, 515, 520, 518, 525, ...],
    "ecgSampleRate": 500,
    "adcGain": 1.0,
    "adcZero": 0.0,
    "ppgData": {
      "red": [1024, 1028, 1032, ...],
      "green": [2048, 2052, 2056, ...],
      "infrared": [1536, 1540, 1544, ...]
    },
    "ppgSampleRate": 100
  }'

响应示例

{
  "errorCode": "0",
  "msg": "成功",
  "data": {
    "sqGrade": "0.95",
    "sbp": 124,
    "dbp": 68
  }
}

响应字段说明

字段	类型	说明	单位	正常范围
sqGrade	string	信号质量等级（详细说明）
sbp	number	收缩压	mmHg	90-120
dbp	number	舒张压	mmHg	60-80

血压分类标准：

分类	收缩压（mmHg）	舒张压（mmHg）
正常血压	< 120	< 80
血压偏高	120-129	< 80
高血压1期	130-139	80-89
高血压2期	≥ 140	≥ 90

使用建议：

测量时保持静坐，手臂与心脏同高
避免在运动、进食、饮酒后立即测量
建议多次测量取平均值
定期使用标准血压计校准

血管健康评估

POST /api/v1/advanced/ppg/vascular-health

基于ECG和PPG信号分析血管弹性，评估血管年龄。

请求参数

参数	类型	必填	说明
ecgData	array	✅	ECG信号数据数组
ecgSampleRate	number	✅	ECG采样率，单位Hz
adcGain	number	❌	增益系数，默认1.0
adcZero	number	❌	零点电压，默认0.0
ppgData	object	✅	PPG信号数据对象
ppgSampleRate	number	✅	PPG采样率，单位Hz

ppgData 对象结构

字段	类型	必填	说明
red	array	✅	红光PPG数据数组
green	array	✅	绿光PPG数据数组
infrared	array	✅	红外光PPG数据数组

请求示例

curl -X POST "https://api.heartvoice.com.cn/api/v1/advanced/ppg/vascular-health" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ecgData": [512, 515, 520, 518, 525, ...],
    "ecgSampleRate": 500,
    "adcGain": 1.0,
    "adcZero": 0.0,
    "ppgData": {
      "red": [1024, 1028, 1032, ...],
      "green": [2048, 2052, 2056, ...],
      "infrared": [1536, 1540, 1544, ...]
    },
    "ppgSampleRate": 100
  }'

响应示例

{
  "errorCode": "0",
  "msg": "成功",
  "data": {
    "sqGrade": "0.95",
    "vascularAge": 61
  }
}

响应字段说明

字段	类型	说明	单位
sqGrade	string	信号质量等级（详细说明）
vascularAge	number	血管年龄	岁

血管年龄解读：

血管年龄与实际年龄差值	评估	建议
差值 ≤ -5岁	优秀	血管弹性极好，继续保持
-5岁 < 差值 ≤ 0岁	良好	血管状态健康
0岁 < 差值 ≤ 5岁	一般	注意血管保养
5岁 < 差值 ≤ 10岁	偏差	建议改善生活方式
差值 > 10岁	较差	建议就医检查

影响血管年龄的因素：

吸烟、饮酒
高血压、高血脂
缺乏运动
不良饮食习惯
长期熬夜、压力大

改善建议：

戒烟限酒
适度有氧运动（每周3-5次，每次30分钟）
多吃新鲜蔬果，减少高脂高盐食物
保持良好作息
定期体检

技术原理

血压估算原理

血压估算基于以下生理学原理和技术方法：

脉搏波传导时间（PTT）：
- 利用ECG的R波与PPG的脉搏波峰之间的时间差
- PTT与血压呈负相关关系
- 公式：PTT = PPG峰时间 - ECG R波时间
PPG波形特征：
- 上升斜率（反映血管弹性）
- 波峰幅度（反映血流量）
- 波形面积（反映每搏输出量）
- 重搏波特征（反映外周阻力）
多通道融合：
- 红光：皮肤浅层血流
- 绿光：心率检测优势
- 红外：深层组织穿透
深度学习模型：
- 结合多维特征的AI模型
- 基于大规模临床数据训练

血管年龄评估原理

血管弹性评估基于：

脉搏波速度（PWV）：
- 利用PTT和已知的动脉路径长度
- PWV越快，血管越硬
增强指数（AI）：
- 分析PPG波形的反射波
- 反映大动脉僵硬度
波形形态分析：
- 上升时间
- 峰值时间
- 舒张期波形

数据要求

信号时长

分析类型	最短时长	推荐时长
血压估算	10秒	30秒
血管健康	10秒	30秒

采样率要求

信号类型	最低采样率	推荐采样率
ECG	250Hz	500Hz
PPG	50Hz	100Hz

测量条件

为确保准确性，请注意：

✅ 正确的测量姿势：

静坐休息5分钟后测量
手臂自然放松，与心脏同高
避免说话、移动

✅ 合适的测量环境：

室温适宜（20-25℃）
避免强光直射传感器
保持安静

❌ 避免以下情况：

剧烈运动后立即测量
进食、饮酒、吸烟后30分钟内
情绪激动时
手指冰冷或出汗

常见问题

Q: 为什么需要同时提供ECG和PPG数据？

A: 血压和血管健康评估依赖于脉搏波传导时间（PTT）的计算，需要ECG的R波时间点和PPG的脉搏波峰时间点。单独使用PPG无法获得准确的PTT值。

Q: PPG三个通道数据的作用是什么？

红光（660nm）：检测皮肤浅层血流，用于血压估算
绿光（520nm）：心率检测最准确，用于PTT计算
红外（940nm）：穿透深度最大，用于血管状态评估

Q: 估算的血压值准确吗？

A: 血压估算的准确性受多种因素影响：

在理想测量条件下，误差通常在±5-10 mmHg范围内
首次使用建议与标准血压计对比校准
仅作为参考，不能替代医用血压计
不作为医疗诊断依据

Q: 多久测量一次比较合适？

日常监测：每天1-2次，早晚各一次
血压异常者：遵医嘱，可能需要更频繁监测
健康人群：每周2-3次即可

下一步

ECG 基础版 API - ECG基础分析
ECG 高阶版 API - ECG高级功能
认证方式 - 获取API Key
使用示例 - 完整集成案例

血压估算​

POST /api/v1/advanced/ppg/blood-pressure​

请求参数​

ppgData 对象结构​

请求示例​

响应示例​

响应字段说明​

血管健康评估​

POST /api/v1/advanced/ppg/vascular-health​

请求参数​

ppgData 对象结构​

请求示例​

响应示例​

响应字段说明​

技术原理​

血压估算原理​

血管年龄评估原理​

数据要求​

信号时长​

采样率要求​

测量条件​

常见问题​

Q: 为什么需要同时提供ECG和PPG数据？​

Q: PPG三个通道数据的作用是什么？​

Q: 估算的血压值准确吗？​

Q: 多久测量一次比较合适？​

下一步​

血压估算

POST /api/v1/advanced/ppg/blood-pressure

请求参数

ppgData 对象结构

请求示例

响应示例

响应字段说明

血管健康评估

POST /api/v1/advanced/ppg/vascular-health

请求参数

ppgData 对象结构

请求示例

响应示例

响应字段说明

技术原理

血压估算原理

血管年龄评估原理

数据要求

信号时长

采样率要求

测量条件

常见问题

Q: 为什么需要同时提供ECG和PPG数据？

Q: PPG三个通道数据的作用是什么？

Q: 估算的血压值准确吗？

Q: 多久测量一次比较合适？

下一步