开放 API（命理 Agent API）

将你的专属命理 Agent 接入第三方应用或自动化工作流。

什么是命理 Agent API

命理 Agent API 是观棋提供的对外开放接口。完成数据校准并开通 Pro 会员后，你可以生成专属 API 密钥，将自己的命理 Agent 嵌入到个人网站、Notion、自动化脚本、Bot 或任何支持 HTTP 调用的应用中。

每次调用会读取你在观棋上沉淀的完整命盘与校准数据，返回的结果与在产品内对话质量一致。

访问条件

同时满足以下两个条件才能生成 API 密钥：

条件	说明
Pro 会员	月付 / 季付 / 年付均可
至少完成一个板块的校准	财富、健康、情感、六亲任意一个

如何生成 API 密钥

打开左侧设置抽屉
导航至记忆库 → 开放 API
点击「创建新项」，可选填一个便于识别的密钥名称
密钥仅在创建时展示一次，请立即复制并妥善保存

如需重新生成，旧密钥会立即失效，请更新所有使用该密钥的应用。

API 端点

POST https://www.nextmove.im/api/v1/agent/chat

请求格式

Headers

Authorization: Bearer <your_api_key>
Content-Type: application/json

Body 参数

参数	类型	必填	说明
`domain`	string	是	对话板块，见下表
`messages`	array	是	对话消息列表（OpenAI 格式）
`stream`	boolean	否	`true` 启用流式响应（SSE），默认 `false`

domain 可选值

值	对应板块
`wealth`	事业财富
`health`	健康
`emotion`	情感婚恋
`family`	家庭六亲
`general`	通用

messages 格式

[
  { "role": "user", "content": "今年的财运怎么样？" }
]

支持多轮对话：将历史消息按顺序传入即可。

完整请求示例

curl -X POST https://www.nextmove.im/api/v1/agent/chat \
  -H "Authorization: Bearer nmk_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "wealth",
    "messages": [
      { "role": "user", "content": "今年的事业方向应该怎么走？" }
    ],
    "stream": false
  }'

响应格式

非流式响应（`stream: false`）

{
  "content": "根据你的命盘与校准数据……",
  "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "domain": "wealth",
  "model": "google/gemini-2.0-flash-001"
}

流式响应（`stream: true`）

响应为 text/event-stream，符合 SSE 标准：

data: {"delta":"根据"}
data: {"delta":"你的"}
data: {"delta":"命盘……"}
data: [DONE]

速率限制与配额

限制项	说明
每分钟请求数	10 次（每个 API 密钥）
月度算力积分	与产品内对话共享同一月度配额
超出限制	返回 `429 Too Many Requests`

算力积分用尽后 API 调用将返回错误，需等下个自然月重置或升级套餐。

错误码

HTTP 状态码	含义
`401`	API 密钥无效或已失效
`403`	不满足访问条件（非 Pro 或未完成校准）
`429`	超出速率限制或月度配额耗尽
`500`	服务端错误，请稍后重试

对话历史与会话

每次调用会在服务端创建一条独立的聊天会话（source: "api"），可在产品内的对话历史中查看，与 Web 端会话区分标注。

使用场景示例

个人主页：将命理 Agent 嵌入网站，访客可直接咨询
Telegram / Discord Bot：通过 Bot 触发命理问答
Notion / 飞书自动化：定期获取流年运势摘要
自定义工作流：结合 n8n、Make、Zapier 等工具构建自动化决策提醒

相关文档：会员与权益 · 算力积分与用量 · 设置与命盘编辑