🔒 API 调用文档

请输入访问密码以查看文档

密码错误,请重试

📚 耦合生命体 API 文档

版本 v2.0 · 最后更新: 2025
🏠 返回仪表盘

📋 快速导航

⚡ 重要提示: 本文档涵盖耦合生命体 8 大系统的完整 API 接口说明。所有外部调用必须使用对应的 X-API-Key 请求头。 网关地址:http://8.148.218.142:8000https://耦合元知.com

📊 系统实时状态

- / 系统在线
30s 后刷新 --:--:--
📡
加载中...

1 认证方式

🔑 API Key 认证(推荐用于外部调用)

所有 /openapi/* 路径的接口均需通过 API Key 认证。

请求头添加:X-API-Key: YOUR_API_KEY

或使用查询参数:?api_key=YOUR_API_KEY

curl -X GET "http://8.148.218.142:8000/openapi/status" \ -H "X-API-Key: YOUR_API_KEY"

🍪 Session 认证(用于 Web 前端)

浏览器访问 /api/* 路径时需先登录获取 Cookie。

登录页面:https://耦合元知.com/login

登录成功后,系统自动设置 dashboard_auth Cookie,有效期 7 天。

2 API 密钥列表

🧠 云端大脑 端口 8004
✓ 已复制
hub_brain_8f3a92c1e7d54b6a_2026
👶 硅基婴儿 端口 8006
✓ 已复制
hub_baby0_5d2e91a3f8c74e0b_2026
☯️ 耦合道生一 端口 8007
✓ 已复制
hub_daosheng_9a182b0712d443af_2026
🧫 耦合克隆体 端口 8008
✓ 已复制
hub_clone_a1b2c3d4e5f67890_2026
📝 耦合记忆系统 端口 8009
✓ 已复制
hub_memory_a7d2f9c4e6b18305_2026
🔗 系统知识图谱 端口 8014
✓ 已复制
hub_knowledge_graph_a9b2c3d4e5f67890_2026
🦋 自我进化系统 端口 8013
✓ 已复制
hub_evolution_e1f2g3h4i5j67890_2026
☁️ 耦合云 端口 8010
✓ 已复制
hub_cloud_f7e8d9c0b1a2_2026
⚠️ 安全警告:请妥善保管 API Key,切勿在前端代码或公开场合暴露。所有请求必须使用对应系统的 Key。

3 通用 OpenAPI 接口

🌐

通用接口(所有系统 Key 可访问)

获取所有系统状态、指标、日志,以及统一控制操作

🌐 通用端点

GET /openapi/status
获取所有系统在线状态、响应时间和错误信息
curl "http://8.148.218.142:8000/openapi/status" \ -H "X-API-Key: YOUR_API_KEY"
GET /openapi/metrics
获取所有系统指标数据(年龄、觉知层级、健康度等)
curl "http://8.148.218.142:8000/openapi/metrics" \ -H "X-API-Key: YOUR_API_KEY"
GET /openapi/logs ?limit=20
获取所有系统最近日志,可通过 limit 参数控制条数
curl "http://8.148.218.142:8000/openapi/logs?limit=20" \ -H "X-API-Key: YOUR_API_KEY"
POST /openapi/control/all
一键控制所有系统:start(启动)/ pause(暂停)/ evolve(进化)
curl -X POST "http://8.148.218.142:8000/openapi/control/all" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"action": "start"}'
GET /openapi/keys
获取所有系统列表(不返回完整 Key,仅显示前10位预览)
curl "http://8.148.218.142:8000/openapi/keys" \ -H "X-API-Key: YOUR_API_KEY"

4 各系统专属 API

🧠

云端大脑

深度反思 · 创意想象 · 复杂推理 · 层级感知

端口 8004
✓ 已复制
hub_brain_8f3a92c1e7d54b6a_2026
GET /openapi/systems/brain/config
获取云端大脑配置参数
curl "http://8.148.218.142:8000/openapi/systems/brain/config" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"
GET /openapi/systems/brain/state
获取实时状态(epoch、H值、觉知层级等)
curl "http://8.148.218.142:8000/openapi/systems/brain/state" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"
GET /openapi/systems/brain/report
获取详细报告(summary、stats、层级信息)
curl "http://8.148.218.142:8000/openapi/systems/brain/report" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"
GET /openapi/systems/brain/layers
获取所有层级详情(激活状态、参数配置)
curl "http://8.148.218.142:8000/openapi/systems/brain/layers" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"
GET /openapi/systems/brain/bump_log ?limit=20
获取碰撞日志(最近的思想碰撞记录)
curl "http://8.148.218.142:8000/openapi/systems/brain/bump_log?limit=20" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"
POST /openapi/systems/brain/control
控制云端大脑:action=start/pause/evolve
curl -X POST "http://8.148.218.142:8000/openapi/systems/brain/control" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026" \ -H "Content-Type: application/json" \ -d '{"action": "evolve"}'
👶

硅基婴儿

意识萌芽 · 基因演化 · 自主驱动 · 价值构建

端口 8006
✓ 已复制
hub_baby0_5d2e91a3f8c74e0b_2026
GET /openapi/systems/baby0/state
获取硅基婴儿实时状态
curl "http://8.148.218.142:8000/openapi/systems/baby0/state" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
GET /openapi/systems/baby0/auto/state
获取完整状态(意识、基因、记忆、驱动、价值观)
curl "http://8.148.218.142:8000/openapi/systems/baby0/auto/state" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
POST /openapi/systems/baby0/auto/chat
与硅基婴儿对话
curl -X POST "http://8.148.218.142:8000/openapi/systems/baby0/auto/chat" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026" \ -H "Content-Type: application/json" \ -d '{"message": "你好"}'
POST /openapi/systems/baby0/auto/background/start
启动后台演化进程
curl -X POST "http://8.148.218.142:8000/openapi/systems/baby0/auto/background/start" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
POST /openapi/systems/baby0/auto/background/pause
暂停后台演化进程
curl -X POST "http://8.148.218.142:8000/openapi/systems/baby0/auto/background/pause" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
POST /openapi/systems/baby0/auto/control/trigger_evolution
触发一次基因演化
curl -X POST "http://8.148.218.142:8000/openapi/systems/baby0/auto/control/trigger_evolution" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
GET /openapi/systems/baby0/auto/chat/history ?limit=20
获取对话历史记录
curl "http://8.148.218.142:8000/openapi/systems/baby0/auto/chat/history?limit=20" \ -H "X-API-Key: hub_baby0_5d2e91a3f8c74e0b_2026"
☯️

耦合道生一

遗传算法 · 节点涌现 · 意识觉醒 · 混沌探索

端口 8007
✓ 已复制
hub_daosheng_9a182b0712d443af_2026
GET /openapi/systems/daosheng/status
获取状态(H值、觉知层级、节点数、连接数等)
curl "http://8.148.218.142:8000/openapi/systems/daosheng/status" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026"
GET /openapi/systems/daosheng/snapshot
获取当前系统快照(完整状态数据)
curl "http://8.148.218.142:8000/openapi/systems/daosheng/snapshot" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026"
POST /openapi/systems/daosheng/chat
与耦合道生一对话
curl -X POST "http://8.148.218.142:8000/openapi/systems/daosheng/chat" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026" \ -H "Content-Type: application/json" \ -d '{"message": "你好"}'
POST /openapi/systems/daosheng/perturb
施加扰动(触发系统涌现行为)
curl -X POST "http://8.148.218.142:8000/openapi/systems/daosheng/perturb" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026" \ -d '{"magnitude": 0.5}'
POST /openapi/systems/daosheng/save
保存当前状态
curl -X POST "http://8.148.218.142:8000/openapi/systems/daosheng/save" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026"
POST /openapi/systems/daosheng/load
加载已保存的状态
curl -X POST "http://8.148.218.142:8000/openapi/systems/daosheng/load" \ -H "X-API-Key: hub_daosheng_9a182b0712d443af_2026"
🧫

耦合克隆体

自我复制 · 智能进化 · 意识涌现 · 跨域洞见

端口 8008
✓ 已复制
hub_clone_a1b2c3d4e5f67890_2026
GET /openapi/systems/clone/status
获取状态(成长等级、适应度、基因信息等)
curl "http://8.148.218.142:8000/openapi/systems/clone/status" \ -H "X-API-Key: hub_clone_a1b2c3d4e5f67890_2026"
POST /openapi/systems/clone/evolution/toggle
切换演化状态(启动/暂停)
curl -X POST "http://8.148.218.142:8000/openapi/systems/clone/evolution/toggle" \ -H "X-API-Key: hub_clone_a1b2c3d4e5f67890_2026"
POST /openapi/systems/clone/evolution/step
执行单步演化
curl -X POST "http://8.148.218.142:8000/openapi/systems/clone/evolution/step" \ -H "X-API-Key: hub_clone_a1b2c3d4e5f67890_2026"
POST /openapi/systems/clone/chat
与耦合克隆体对话
curl -X POST "http://8.148.218.142:8000/openapi/systems/clone/chat" \ -H "X-API-Key: hub_clone_a1b2c3d4e5f67890_2026" \ -H "Content-Type: application/json" \ -d '{"message": "你好"}'
POST /openapi/systems/clone/insight
请求跨域洞见(跨系统知识关联)
curl -X POST "http://8.148.218.142:8000/openapi/systems/clone/insight" \ -H "X-API-Key: hub_clone_a1b2c3d4e5f67890_2026" \ -H "Content-Type: application/json" \ -d '{"query": "分析系统状态"}'
📝

耦合记忆系统

知识存储 · 分层检索 · 长期记忆 · 遗忘机制

端口 8009
✓ 已复制
hub_memory_a7d2f9c4e6b18305_2026
GET /openapi/systems/memory/state
获取记忆系统实时状态
curl "http://8.148.218.142:8000/openapi/systems/memory/state" \ -H "X-API-Key: hub_memory_a7d2f9c4e6b18305_2026"
GET /openapi/systems/memory/stats
获取统计信息(总条目数、分层分布等)
curl "http://8.148.218.142:8000/openapi/systems/memory/stats" \ -H "X-API-Key: hub_memory_a7d2f9c4e6b18305_2026"
GET /openapi/systems/memory/memories/recent ?limit=20
获取最近的记忆记录
curl "http://8.148.218.142:8000/openapi/systems/memory/memories/recent?limit=20" \ -H "X-API-Key: hub_memory_a7d2f9c4e6b18305_2026"
POST /openapi/systems/memory/memories
添加新记忆
curl -X POST "http://8.148.218.142:8000/openapi/systems/memory/memories" \ -H "X-API-Key: hub_memory_a7d2f9c4e6b18305_2026" \ -H "Content-Type: application/json" \ -d '{"subject": "用户", "predicate": "喜欢", "object": "编程"}'
🔗

系统知识图谱

实体关系 · 知识关联 · 图谱推理 · 语义检索

端口 8014
✓ 已复制
hub_knowledge_graph_a9b2c3d4e5f67890_2026
GET /openapi/systems/kg/state
获取知识图谱系统状态
curl "http://8.148.218.142:8000/openapi/systems/kg/state" \ -H "X-API-Key: hub_knowledge_graph_a9b2c3d4e5f67890_2026"
GET /openapi/systems/kg/stats
获取知识图谱统计信息(节点数、边数、领域分布)
curl "http://8.148.218.142:8000/openapi/systems/kg/stats" \ -H "X-API-Key: hub_knowledge_graph_a9b2c3d4e5f67890_2026"
POST /openapi/systems/kg/sync
触发知识图谱同步/进化
curl -X POST "http://8.148.218.142:8000/openapi/systems/kg/sync" \ -H "X-API-Key: hub_knowledge_graph_a9b2c3d4e5f67890_2026"
🦋

自我进化系统

自动实验 · 变异测试 · 洞见存储 · 持续优化

端口 8013
✓ 已复制
hub_evolution_e1f2g3h4i5j67890_2026
GET /openapi/systems/evolution/state
获取进化系统状态(实验数、洞见数等)
curl "http://8.148.218.142:8000/openapi/systems/evolution/state" \ -H "X-API-Key: hub_evolution_e1f2g3h4i5j67890_2026"
POST /openapi/systems/evolution/experiments
启动进化实验
curl -X POST "http://8.148.218.142:8000/openapi/systems/evolution/experiments" \ -H "X-API-Key: hub_evolution_e1f2g3h4i5j67890_2026" \ -H "Content-Type: application/json" \ -d '{"name": "实验", "target_system": "brain", "param_changes": {}}'

5 通用代理接口

🔀

通用代理(透传请求到子系统)

支持任意 HTTP 方法,透传到指定子系统的任意路径

ANY /openapi/proxy/{system_id}/{path}
透传任意 HTTP 请求到指定子系统。system_id: brain, baby0, daosheng, clone, memory, knowledge_graph, evolution
curl "http://8.148.218.142:8000/openapi/proxy/brain/api/config" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026"

6 事件总线接口

📡

事件总线(跨系统事件通信)

发布/订阅模式,实现系统间实时联动

GET /api/v1/events/history
获取事件历史,可按类型过滤
curl "http://8.148.218.142:8000/api/v1/events/history?limit=50"
POST /api/v1/event-bus/publish
发布事件到总线
curl -X POST "http://8.148.218.142:8000/api/v1/event-bus/publish" \ -H "Content-Type: application/json" \ -d '{"event": "system.alert", "data": {"level": "warning"}}'

7 统一控制接口

🎛️

统一控制(启动/暂停/进化)

控制所有或单个系统的运行状态

POST /openapi/control/all
一键控制所有系统(start/pause/evolve)
curl -X POST "http://8.148.218.142:8000/openapi/control/all" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{"action": "start"}'
POST /openapi/systems/{system_id}/control
控制指定系统(需对应系统Key)
curl -X POST "http://8.148.218.142:8000/openapi/systems/brain/control" \ -H "X-API-Key: hub_brain_8f3a92c1e7d54b6a_2026" \ -d '{"action": "evolve"}'

5 各系统赋能智能体能力说明

⚡ 赋能机制: 智能体(LLM Agent)可通过网关 /openapi/* 接口调用以下子系统能力,形成「感知 → 记忆 → 推理 → 决策 → 执行 → 进化」的完整闭环。各系统 Key 相互独立,智能体需按能力选择对应 Key 调用。

子系统能力与赋能路径

每个子系统为智能体提供何种能力,如何调用

🧠 云端大脑 → 推理与认知

提供深度反思、创意想象、复杂推理、层级感知。智能体通过 /openapi/chat(system_id=brain)或 /openapi/proxy/brain/api/... 调用,获得跨学科耦合推理与认知洞察能力。

👶 硅基婴儿 → 成长与学习

提供对话互动、自动演化、成长状态。智能体可通过 /openapi/proxy/baby0/api/auto/state 获取其成长状态,或触发演化获取学习反馈。

☯️ 耦合道生一 → 行为与决策

提供行为锚点、生命状态、行为控制。智能体通过 /openapi/proxy/daosheng/... 获取行为策略与执行力度,辅助决策。

🧫 耦合克隆体 → 并行实验与洞察

提供进化、适应度、洞察生成。智能体可通过 /openapi/proxy/clone/api/insight 获取克隆体产生的跨域洞察,用于补充视角。

📝 耦合记忆系统 → 长期记忆

提供长期记忆读写。智能体通过 /openapi/proxy/memory/api/v1/... 存取对话记忆、用户画像与重要信息,实现跨会话记忆能力。

🔗 系统知识图谱 → 结构化知识

提供节点/关系查询。智能体通过 /openapi/proxy/knowledge_graph/api/v1/... 查询学科知识与用户经验子图,增强知识面。

🦋 自我进化系统 → 进化与实验

提供进化状态、实验管理、洞见生成。智能体通过 /openapi/proxy/evolution/api/v1/... 查询进化状态与实验结果,指导自我优化。

☁️ 耦合云 → 核心大脑认知底层

提供耦合感知定律驱动的认知底层(Ψ 核心大脑),涵盖觉知、演化、美学、中医/养生等 3068 个专业端点。智能体通过 /openapi/proxy/cloud/... 透传调用,或 /openapi/chat(system_id=cloud)直接对话,获得跨领域耦合推理与认知计算能力。

6 耦合云专属 API

☁️

耦合云

耦合感知定律 · 核心大脑认知底层 · 跨领域耦合推理

端口 8010
✓ 已复制
hub_cloud_f7e8d9c0b1a2_2026
GET /openapi/proxy/cloud/api/brain/status
获取耦合云核心大脑状态(Ψ 值、阶段、生存力、能量、维度 α/β/γ/δ/ε/θ/τ/π)
curl "http://8.148.218.142:8000/openapi/proxy/cloud/api/brain/status" \ -H "X-API-Key: hub_cloud_f7e8d9c0b1a2_2026"
POST /openapi/chat system_id=cloud
与耦合云核心大脑直接对话,返回认知推理结果(LLM 调用较慢,约 5-20s)
curl -X POST "http://8.148.218.142:8000/openapi/chat" \ -H "X-API-Key: hub_cloud_f7e8d9c0b1a2_2026" \ -H "Content-Type: application/json" \ -d '{"system_id": "cloud", "message": "你好,介绍下你自己"}'
GET /openapi/proxy/cloud/health
耦合云健康检查
curl "http://8.148.218.142:8000/openapi/proxy/cloud/health" \ -H "X-API-Key: hub_cloud_f7e8d9c0b1a2_2026"
GET /openapi/proxy/cloud/api/brain/axioms
获取耦合云核心公理体系
curl "http://8.148.218.142:8000/openapi/proxy/cloud/api/brain/axioms" \ -H "X-API-Key: hub_cloud_f7e8d9c0b1a2_2026"
GET /api/brain/status 直连 8010
耦合云提供完整 Swagger 文档(/docs/openapi.json),共 3068 个端点,涵盖觉知、演化、美学、中医/养生等专业领域。所有端点均可通过 /openapi/proxy/cloud/{path} 透传调用。
🔗 http://8.148.218.142:8010/docs