ECG 高阶版 API
高阶版在基础分析基础上,提供心率变异性分析、心脏年龄评估、心理情绪评估、微体检等高级功能。
订阅要求
高阶版API需要高阶版订阅。查看定价
信号质量说明
所有分析接口都会返回 sqGrade 字段表示信号质量。建议 sqGrade ≥ 0.7 时使用分析结果。
查看信号质量详细说明 →
重点传参解释
- adcZero(ADC 零点偏移 / 基线零点) 心电设备采集信号的基准零电位,也就是心电图平直基线的位置。
- adcGain(ADC 增益倍数 / 放大系数) 心电微弱电信号的放大倍率,校准心电图波形幅度大小.
我们算法最终需要的心电数值是原始心电电压值毫伏mv单位,转化公式如下: mv = (原始adc数值-adcZero) / adcGain 注:各项参数用于心电数据标准化转换,参数正确才能保证 AI 心电分析结果准确有效
ECG完整分析
POST /api/v1/advanced/ecg/analyze
包含基础版所有分析结果,额外增加心脏年龄、呼吸频率、HRV、压力情绪指标、疾病风险等高级分析。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ecgData | array | ✅ | ECG信号数据数组(ADC值) |
| ecgSampleRate | number | ✅ | 采样率,单位Hz(推荐250-500) |
| adcGain | number | ❌ | 增益系数,默认1.0 |
| adcZero | number | ❌ | 零点电压(基线电压),默认0.0 |
请求示例
curl -X POST "https://api.heartvoice.com.cn/api/v1/advanced/ecg/analyze" \
-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
}'
响应示例
{
"errorCode": "0",
"msg": "成功",
"data": {
"isAbnormal": false,
"isReverse": false,
"sqGrade": "0.95",
"diagnosis": [
"SN"
],
"possibleDiags": [],
"pacCount": 0,
"pvcCount": 0,
"avgHr": 73,
"avgQrs": 94,
"prInterval": 152,
"avgQt": 348,
"avgP": 104,
"avgQtc": 384,
"heartAge": 36,
"respiratoryRate": 12,
"hrv": 25.32,
"pressure": 19.56,
"emotion": 31.02,
"fatigue": 100.0,
"vitality": 57.81,
"riskMapping": {
"AVBI": 0.001,
"AE": 0.001,
"AF": 0.001,
"SNB": 0.0,
"SNA": 0.0,
"AFL": 0.0,
"PJC": 0.002,
"VE": 0.003,
"SVT": 0.002,
"AVBII": 0.0,
"PAC": 0.003,
"IVB": 0.012,
"PACED": 0.002,
"LBBB": 0.001,
"RBBB": 0.014,
"SNT": 0.0,
"AVBIII": 0.0,
"SN": 0.8,
"JE": 0.007,
"PVC": 0.007,
"VT": 0.0,
"WPW": 0.002
}
}
}
诊断标签说明
diagnosis 和 possibleDiags 字段返回的是诊断标签代码,请参考诊断标签对照表转换为中文描述。
响应字段说明
除了包含基础版的所有字段外,还额外提供:
| 字段 | 类型 | 说明 | 单位 |
|---|---|---|---|
| heartAge | number | 心脏年龄 | 岁 |
| respiratoryRate | number | 呼吸频率 | 次/分 |
| hrv | number | 心率变异性 | 标准差 |
| pressure | number | 压力指数 | 0-1 |
| emotion | number | 情绪指数 | 0-1 |
| fatigue | number | 疲劳指数 | 0-1 |
| vitality | number | 活力指数 | 0-1 |
| riskMapping | map | 疾病风险概率 | 0-1 |
信号质量
所有接口都会返回 sqGrade 字段表示信号质量。查看详细说明
指标解读:
- pressure(压力指数):值越高表示压力越大,< 0.3为低压力,0.3-0.6为中等压力,> 0.6为高压力
- emotion(情绪指数):值越高表示情绪越积极,< 0.4为负面,0.4-0.7为中性,> 0.7为积极
- fatigue(疲劳指数):值越高表示越疲劳,< 0.3为不疲劳,0.3-0.6为轻度疲劳,> 0.6为重度疲劳
- vitality(活力指数):值越高表示活力越足,< 0.4为低活力,0.4-0.7为中等活力,> 0.7为高活力