快速开始

欢迎使用 AIECG 心电信号分析云服务！本指南将帮助您在 3分钟内 完成API集成。

🎯 AIECG 是什么？

AIECG 提供专业的心电（ECG）信号分析API服务，让您的穿戴设备、健康应用具备医疗级心电诊断能力。

核心能力：

• ✅ 98.6% 诊断准确率
• ✅ 3s 平均响应时间
• ✅ 单导联支持 20种以上心律失常识别，12导联支持43种以上 心电病症
• ✅ 支持 单导联 和 12导联 分析
• ✅ 简单易用，5行代码 完成集成

---

📦 第一步：获取 API Key

1. 访问 开发者控制台
2. 在「API密钥」页面复制您的密钥

sk-aiecg-xxxxxxxxxxxxxxxxxxxxxxxx

新用户福利

注册即送 100次 免费API调用额度，足够您完成开发测试！

---

🚀 第二步：调用 API

单导联ECG分析

cURL

curl -X POST "https://api.heartvoice.com.cn/v1/basic/ecg/1-lead/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ecgData": [512, 515, 520, 518, 525, 530, 528, 522, 515, 508, ...],
    "ecgSampleRate": 500,
    "adcGain": 1000.0,
    "adcZero": 0.0
  }'

JavaScript

const response = await fetch('https://api.heartvoice.com.cn/v1/basic/ecg/1-lead/analyze', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ecgData: ecgSignalData,    // 您的ECG信号数组
    ecgSampleRate: 500,        // 采样率 (Hz)
    adcGain: 1000.0,          // 增益系数
    adcZero: 0.0              // 零点电压
  })
});

const result = await response.json();

console.log(result.data.diagnosis);     // ["SINUS_RHYTHM", "NORMAL_ECG"]
console.log(result.data.avgHr);        // 72
console.log(result.data.sqGrade);      // "0.92"

Python

import requests

response = requests.post(
    'https://api.heartvoice.com.cn/v1/basic/ecg/1-lead/analyze',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'ecgData': ecg_signal_data,    # 您的ECG信号列表
        'ecgSampleRate': 500,          # 采样率 (Hz)
        'adcGain': 1000.0,            # 增益系数
        'adcZero': 0.0                # 零点电压
    }
)

result = response.json()

print(f"诊断: {', '.join(result['data']['diagnosis'])}")  # SINUS_RHYTHM, NORMAL_ECG
print(f"心率: {result['data']['avgHr']} BPM")
print(f"信号质量: {result['data']['sqGrade']}")

---

📊 响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "isAbnormal": false,
    "isReverse": false,
    "sqGrade": "0.92",
    "diagnosis": [
      "SINUS_RHYTHM",
      "NORMAL_ECG"
    ],
    "possibleDiags": [],
    "pacCount": 0,
    "pvcCount": 1,
    "avgHr": 72,
    "avgQrs": 88,
    "prInterval": 160,
    "avgQt": 380,
    "avgP": 100,
    "avgQtc": 392
  }
}

关键字段说明

字段	说明
isAbnormal	是否检测到异常
isReverse	导联是否反接
sqGrade	信号质量等级（数值字符串，0-1）
diagnosis	诊断标签数组（返回标签代码）
possibleDiags	可能的诊断标签数组
avgHr	平均心率 (bpm)
avgQrs	平均QRS宽度 (ms)
prInterval	PR间期 (ms)
avgQt	平均QT间期 (ms)
avgQtc	校正QT间期 (ms)
pacCount	房性早搏计数
pvcCount	室性早搏计数

诊断标签说明

diagnosis 字段返回的是诊断标签代码（如 SINUS_RHYTHM），需要根据诊断标签对照表转换为中文描述。

---

🎉 完成！

恭喜！您已成功完成 AIECG API 的第一次调用。

下一步

📖 ECG基础版

单导联和12导联分析详细文档

查看文档

🔬 ECG高阶版

HRV、心脏年龄、DeepLife等

查看文档

🧪 在线测试

使用Playground测试API

立即测试

---

📚 API 接口一览

ECG 心电分析

接口	说明	套餐
POST /v1/basic/ecg/1-lead/analyze	单导联ECG分析	基础版+
POST /v1/basic/ecg/12-lead/analyze	12导联ECG分析	基础版+
POST /v1/advanced/ecg/analyze	ECG完整分析(含HRV、心脏年龄等)	高阶版+
POST /v1/advanced/ecg/heart-age	心脏年龄评估	高阶版+
POST /v1/advanced/ecg/mental-state	心理情绪评估	高阶版+
POST /v1/advanced/ecg/micro-exam	DeepLife微体检	高阶版+
POST /v1/advanced/ecg/holter/*	长程心电分析(异步)	高阶版+

PPG 脉搏波分析

接口	说明	套餐
POST /v1/advanced/ppg/blood-pressure	血压估算	高阶版+
POST /v1/advanced/ppg/vascular-health	血管健康评估	高阶版+

---

💬 需要帮助？

• 📧 技术支持：contact@heartvoice.com.cn
• ☎ 合作热线：400-0551-927
• 📱 电话：18055165745(祺经理)