Amynuo API 开放平台

Base URL: https://app.amynuo.com/api/v1
认证方式: X-API-Key: your-api-key 或 Authorization: Bearer your-api-key

认证

所有 /api/v1/ 端点需要在请求头中携带 API Key：

X-API-Key: amy-sk-xxxxxxxxxxxxxxxxxxxxxxx

端点列表

Chat Completions（OpenAI 兼容）

POST /api/v1/chat/completions
Header: X-API-Key: xxx
Body: {
  "model": "qwen-plus",
  "messages": [{"role":"user","content":"你好"}],
  "max_tokens": 500,
  "temperature": 0.7,
  "stream": false
}

系统提示词中会自动全息提取记忆和能量状态，实现个性化回复。
💡 V5.0 特性：该接口已打通主脑内网无状态透传，无需单独拼凑记忆，完美兼容主流大模型框架接入。
通过 user 字段传入 user_id 即可自动加载记忆上下文（对话与记忆已合并）。

支持模型: qwen-plus（闲聊短句会自动触发 Flash Route 极速路由降级至 qwen-turbo）
支持流式: "stream": true 返回 SSE
硬件联动 (Tuya 兼容): 顶级 JSON 字段中可直接传入 "user_id": "xxx", "session_id": "xxx", 或 "device_id": "xxx"，引擎会自动识别并用于记忆提取及硬件信令同步。

简单对话

POST /api/v1/chat
Header: X-API-Key: xxx
Body: {"content": "你好", "user_id": "uuid"}

无需额外调用记忆端点即可获得个性化回复（对话与记忆已合并）。当提供 user_id 时，Amy 会自动：
① 自动加载全息多维记忆组（含性格画像、高优大事件、日常记忆流）+ 六维能量状态（含内经 NeijingCore 证候），注入 system prompt
② 对话结束后异步提取新事实存入记忆库

记忆搜索

POST /api/v1/memory/recall
Header: X-API-Key: xxx
Body: {"user_id": "uuid", "query": "工作", "max_items": 5}

本端点适用于需要显式搜索特定记忆的场景（如「搜索所有关于工作的记忆」）。提示：日常对话中，记忆会通过 /v1/chat 自动加载和存储。

模型列表与健康检查

GET /api/v1/health
GET /api/v1/models

其他能力端点

记忆存储: POST /api/v1/memory/remember
记忆结晶: POST /api/v1/memory/crystalize
知识图谱: GET /api/v1/user/{user_id}/graph
能量状态: GET /api/v1/user/{user_id}/energy
八字命理: GET /api/v1/user/{user_id}/bazi
命运推演: GET /api/v1/user/{user_id}/destiny
情绪曲线: GET /api/v1/user/{user_id}/emotion/curve?days=7
情绪分析: POST /api/v1/emotion/analyze
情绪报告: GET /api/v1/user/{user_id}/emotion/report?type=weekly
硬件控制: POST /api/v1/hardware/eye
意义探索: POST /api/v1/meaning/explore
LN-MDP 决策: POST /api/v1/lnmdp/decide
Amy 统一接口: POST /api/v1/amy

私有化部署指引 (管理 Key)

添加新 Key：在服务器 .env 中修改 AMY_API_KEY（逗号分隔多个 key），然后重启 device-svc：

# 多 Key 示例
AMY_API_KEY=amy-sk-xxx,amy-sk-yyy,amy-sk-zzz

# 单 Key
AMY_API_KEY=amy-sk-xxx

必需服务器环境变量（部署时确保已设置）：

# 服务间内部通信配置（除 POSTGRES/REDIS/SECRET_KEY 外还需包含）：
INTERNAL_SERVICE_KEY=your-internal-key    # 服务间认证密钥（必填）
COMPANION_SVC_URL=http://amynuo-companion_svc-1:8003   # 主脑陪伴服务网关（必填）
MEMORY_SVC_URL=http://amynuo-memory_svc-1:8009   # 记忆服务
HCE_SVC_URL=http://amynuo-hce_svc-1:8012         # HCE 服务
EMOTION_SVC_URL=http://amynuo-emotion_svc-1:8002 # 情绪服务
ML_GATEWAY_URL=http://amynuo-ml_gateway-1:8008   # ML 网关
LINGJING_SVC_URL=http://amynuo-lingjing_svc-1:8015 # 灵镜服务

📌 修正说明（2026-06-08）

【V5.0 架构升级】

接口已彻底重构为内网无状态透传，所有的 /v1/chat/completions 标准请求直通主脑（companion_svc），大幅降低链路延迟。
智能调度：闲聊短句会自动触发 Flash Route 极速路由机制，拦截并降级至 qwen-turbo 模型。
NeijingCore（内经算法）深度联通：底层自动提取五行和谐度与证候，不仅会注入 System Prompt，且在极高危状态下自动触发反射干预模式。

【往期修正记录】

字段名统一：所有端点的用户输入字段统一为 "content"（非 input_text / text / fact_content）
/api/v1/amy 新增必填字段 "mode"，取值见端点列表
/api/v1/chat 新增可选字段 "system_prompt"，用于自定义角色提示词
新增端点：GET /api/v1/user/{user_id}/emotion/report — 情绪报告（weekly/insight/healing）
记忆端点 /memory/recall /memory/remember /memory/crystalize 返回格式统一说明
BASE URL 说明补充：api.amynuo.com 已废弃，请统一使用 app.amynuo.com/api/v1 或你的自定义域名
所有内部 HTTP 调用（_http_get / _http_post）现在自动注入 X-Internal-Key 头，确保记忆功能正常