📥 0. 测试数据源 (仅用于脑龄/入睡指数)
在调用算法前，请先下载脑电测试数据。该数据包含一个大的浮点数数组。
状态: 未加载
POST/api/resource/InnerToken/post
通过用户名密码换取 JWT Token。成功后会自动填充上方 Token 栏。
Request Info
Waiting...
Response Data
Waiting...
GET/api/resource/InnerToken/getone
Request Info
Waiting...
Response Data
Waiting...
POST/api/special/run-algorithm/plus
Instance ID 机制说明：
1. 冷启动优化：算法服务器闲置 120s 后会休眠。使用
2. 单线程限制：每个算法实例是单线程的。高并发生产环境建议不传 ID 或为每个用户分配唯一 ID，防止阻塞。
3. 不传 ID (空)：进入默认负载均衡池（可能每次都遇到冷启动）。
1. 冷启动优化：算法服务器闲置 120s 后会休眠。使用
instanceId
可以保持会话，避免频繁冷启动带来的高延迟。2. 单线程限制：每个算法实例是单线程的。高并发生产环境建议不传 ID 或为每个用户分配唯一 ID，防止阻塞。
3. 不传 ID (空)：进入默认负载均衡池（可能每次都遇到冷启动）。
⚠️ 费用警告：
如果您传递大量不同的自定义字符串作为 ID，系统会创建对应数量的虚拟服务器实例，可能导致高额费用。请根据业务权衡。
如果您传递大量不同的自定义字符串作为 ID，系统会创建对应数量的虚拟服务器实例，可能导致高额费用。请根据业务权衡。
| 参数类型 | 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 入参 | params |
是 | Array | 固定为 [0, 0] |
| 入参 | nargout |
是 | Number | 期望的返回值数量，固定为 1 |
| 入参 | instanceId |
否 | String | 实例ID，用于保持会话，空字符串表示随机分配 |
| 出参 | results |
- | Number | 预热成功固定返回 0 |
| 出参 | instanceId |
- | String | 云端分配或确认的实例ID，后续业务请求需带上以复用实例 |
| 出参 | status |
- | String | 接口调用状态，如 "success" |
Request Info
Waiting...
Response Data
Waiting...
POST/api/special/run-algorithm/YLBA_mainfunction
传递全量数据进行分析。
| 参数类型 | 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 入参 | params[0] |
是 | Array[Float] | 单通道完整脑电数据，建议至少10秒以上的有效数据 |
| 入参 | params[1] |
是 | Number | 采样率，通常为 250 |
| 入参 | params[2] |
是 | Number | 用户的真实年龄（数值类型） |
| 出参 | results[0][0] |
- | Number | 实际年龄 (ageReal) |
| 出参 | results[0][1] |
- | Number | 预测脑龄 (agePred) |
| 出参 | results[0][2] |
- | Number | 专注度评分（百分制） |
| 出参 | results[0][3] |
- | Number | 放松度评分（百分制） |
| 出参 | results[0][4] |
- | Number | 疲劳度评分（百分制） |
| 核心指标对比 (用户自身 vs 同龄段均值) | ||||
| 出参 | results[0][5] |
- | Number | 用户 Alpha 频段相对功率 (%) |
| 出参 | results[0][6] |
- | Number | 同龄段 Alpha 频段相对功率均值 (%) |
| 出参 | results[0][7] |
- | Number | 用户 Gamma 频段相对功率 (%) |
| 出参 | results[0][8] |
- | Number | 同龄段 Gamma 频段相对功率均值 (%) |
| 出参 | results[0][9] |
- | Number | 用户 Alpha/Theta 频段功率比值 |
| 出参 | results[0][10] |
- | Number | 同龄段 Alpha/Theta 功率比值均值 |
| 出参 | results[0][11] |
- | Number | 用户 Beta/Theta 频段功率比值 |
| 出参 | results[0][12] |
- | Number | 同龄段 Beta/Theta 功率比值均值 |
| 出参 | results[0][13] |
- | Number | 用户 IAF (个体 Alpha 峰值频率, Hz) |
| 出参 | results[0][14] |
- | Number | 同龄段 IAF 均值 (Hz) |
| 出参 | results[0][15] |
- | Number | 用户 Gamma 频段维纳熵 (谱平坦度) |
| 出参 | results[0][16] |
- | Number | 同龄段 Gamma 频段维纳熵均值 |
| 出参 | results[0][17] |
- | Number | 用户 信号干扰指数 (Beta 频段相对功率, %) |
| 出参 | results[0][18] |
- | Number | 同龄段 信号干扰指数均值 (%) |
| 出参 | results[0][19] |
- | Number | 睡眠障碍风险指数 (SDRI) |
Request Info (数组过大时，显示已折叠)
Waiting...
Response Data
Waiting...
POST/api/special/run-algorithm/YL_getSOI
滑动窗口机制：
每次请求需要 10秒 (2500点) 的数据。通过设置步进时间（Overlap）来控制调用频率。
例如：步进 1秒 = 90% 重叠 (0-10s, 1-11s...); 步进 5秒 = 50% 重叠 (0-10s, 5-15s...)。
注：需将上一次返回的 State (results[2]) 传回。
每次请求需要 10秒 (2500点) 的数据。通过设置步进时间（Overlap）来控制调用频率。
例如：步进 1秒 = 90% 重叠 (0-10s, 1-11s...); 步进 5秒 = 50% 重叠 (0-10s, 5-15s...)。
注：需将上一次返回的 State (results[2]) 传回。
(每点一次按钮前进的时间)
当前窗口范围: 0 - 0 (Total:
0)
窗口大小: 10s (2500 pts)
历史状态 (State):
无 (Initial)
执行结果历史
| 参数类型 | 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 入参 | params[0] |
是 | Array[Float] | 单 epoch 原始脑电信号（例如 10秒窗口 共 2500 个点） |
| 入参 | params[1] |
是 | Number | 采样率浮点数，固定为 250.0 |
| 入参 | params[2] |
否 | Number/Array |
上一个 epoch 的平滑 SOI 状态 (preSOI)。首次请求传空数组
[]
|
| 出参 | results[0] |
- | Number | 当前 epoch 的入睡指数 (SOI) 评分，范围约 0-100，越高越接近入睡 |
| 出参 | results[1][0] |
- | Array[Float] | 提取的 8 维脑电特征向量 (包含 Delta/Theta 相对功率等) |
| 出参 | results[2] |
- | Number |
更新后的平滑 SOI 值 (状态)，需保存并在下一次请求作为
params[2] 传入
|
Request Info (显示 10s 数据切片)
Waiting...
Response Data
Waiting...
POST/api/special/run-algorithm/YL_getSleepScore
计算睡眠评分。参数 1：睡眠分期数组（可编辑）；参数
2：入睡时间（0-23点）。
| 参数类型 | 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 入参 | params[0] |
是 | Array[Int] | 睡眠分期标签 (0=Wake, 1=Light, 2=Deep, 3=REM)，每点代表30秒 |
| 入参 | params[1] |
是 | Number | 记录开始时刻 (0-23小时) |
| 出参 | results[0][0] |
- | Number | 综合睡眠质量得分 (0-100，四舍五入) |
| 出参 | results[0][1] |
- | Number | 总睡眠时长 (分钟) |
| 出参 | results[0][2] |
- | Number | 中途清醒时长 (分钟) |
| 出参 | results[0][3] |
- | Number | 浅睡时长 (分钟) |
| 出参 | results[0][4] |
- | Number | 浅睡占比 (0-1) |
| 出参 | results[0][5] |
- | Number | 深睡时长 (分钟) |
| 出参 | results[0][6] |
- | Number | 深睡占比 (0-1) |
| 出参 | results[0][7] |
- | Number | REM 时长 (分钟) |
| 出参 | results[0][8] |
- | Number | REM 占比 (0-1) |
| 出参 | results[0][9] |
- | Number | 入睡时刻 (当天累计秒数) |
| 出参 | results[0][10] |
- | Number | 终末清醒时刻 (当天累计秒数) |
Request Info
Waiting...
Response Data
Waiting...
POST
/api/special/run-algorithm/YL_getSOI_simplify
简化版 SOI (YL_getSOI_simplify)：输入 1
秒级底层评分特征
[Attention, Relaxation, Fatigue]，通过推断引擎输出 4
个离散睡眠阶段（1=清醒、2=放松/过渡、3=浅睡、4=稳定睡眠）及状态句柄。
状态流转说明：
1. 按秒调用：外层按 1 秒间隔调用本接口，传入当秒特征
2. 上下文句柄透传：首次调用时
3. nargout 设置：请求 Body 中的
1. 按秒调用：外层按 1 秒间隔调用本接口，传入当秒特征
features_in。2. 上下文句柄透传：首次调用时
params[1] ~
params[4] 全部传空数组
[]。后续调用时，需将上一次接口吐出的
results[1] ~ results[4] 原样透传回对应的
params[1] ~ params[4]。3. nargout 设置：请求 Body 中的
nargout 必须固定设置为 5。
实时特征输入 (1 秒)：
快速预设：
记忆体状态:
无 (Initial)
当前阶段 (current_stage):
未计算
平滑 SOI (internal_soi):
未计算
推断日志历史
| 参数类型 | 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 入参 | params[0] |
是 | Array[Float] |
包含当前 1 秒内底层 3 个指标:
[Attention, Relaxation, Fatigue] (0-100)
|
| 入参 | params[1] |
否 | Array[Float] |
算法概率状态句柄。首次调用传 []，后续透传上一次的
results[1]
|
| 入参 | params[2] |
否 | Matrix |
算法缓冲队列句柄。首次调用传 []，后续透传上一次的
results[2]
|
| 入参 | params[3] |
否 | Number |
算法平滑状态句柄。首次调用传 []，后续透传上一次的
results[3]
|
| 入参 | params[4] |
否 | Array[Int] |
算法防抖状态句柄。首次调用传 []，后续透传上一次的
results[4]
|
| 入参 | nargout |
是 | Number | 期望返回参数数量，固定为 5 |
| 入参 | instanceId |
否 | String | 算法服务端实例 ID |
| 输出结果 (Results) 说明 | ||||
| 出参 | results[0] |
- | Number (Int) |
推断睡眠阶段 (current_stage)：1 = 清醒
(Wake)2 = 放松/过渡 (Relax/Transition)3
= 浅睡 (Light Sleep)4 = 稳定睡眠 (Stable
Sleep)
|
| 出参 | results[1] |
- | Array[Float] | 概率状态句柄，下一次原样透传回 params[1] |
| 出参 | results[2] |
- | Matrix | 缓冲队列句柄，下一次原样透传回 params[2] |
| 出参 | results[3] |
- | Number |
平滑状态句柄 (内部 SOI)，下一次原样透传回 params[3]
|
| 出参 | results[4] |
- | Array[Int] | 防抖状态句柄，下一次原样透传回 params[4] |
Request Info
Waiting...
Response Data
Waiting...