API 调用 AI

不绑微信 / 飞书，也可以通过 HTTP 接口触发同一个 AI 机器人，适合AI硬件接入。

接口背后与聊天渠道走同一条链路：AI 同样能检索 / 发表 / 修改你的笔记，消息上下文、角色设定 / 记忆、用户画像等配置也都取自 设置 → AI 机器人 页。

准备

1. 账号已开通 AI 机器人（即微信 / 飞书里能正常聊天的状态）。
2. 在 设置 → 我的账号 → 访问 Token 创建一个 API Token：
   • 权限选 读写（所有权限）
   • 空间选 全部

接口

POST /api/v1/aibot/chat

请求头带 Authorization: Bearer <你的API Token>，Body 为 JSON：

参数	类型	必填	说明
content	string	必填	消息文本，最长 64KB；发 /new 可开新对话
stream	bool	选填	默认 true 流式返回；false 等生成完一次性返回

非流式（stream=false）

curl -X POST "https://cflow.cc/api/v1/aibot/chat" \
  -H "Authorization: Bearer <你的API Token>" \
  -H "Content-Type: application/json" \
  -d '{"content": "帮我总结一下今天的笔记", "stream": false}'

返回 JSON：

字段	说明
reply	AI 的完整回复；出错时为错误提示文案
errcode	0 正常；非 0 为业务错误码

流式（默认）

返回 SSE 流，逐段收到 AI 回复：

curl -N -X POST "https://cflow.cc/api/v1/aibot/chat" \
  -H "Authorization: Bearer <你的API Token>" \
  -H "Content-Type: application/json" \
  -d '{"content": "帮我总结一下今天的笔记"}'

事件格式：

事件	说明
data: {"type": "text", "content": "..."}	AI 的回复文本段，按顺序拼接即为完整回复
data: {"type": "function" / "reasoning", ...}	工具调用、思考过程等调试事件，展示与否由调用方决定
data: {"type": "user_error", ...}	业务错误，content 为可直接展示的错误文案
event: done	正常结束
event: error	异常终止，流不完整

Python 示例（拼接流式回复）：

import json, requests

resp = requests.post(
    "https://cflow.cc/api/v1/aibot/chat",
    headers={"Authorization": "Bearer <你的API Token>"},
    json={"content": "帮我总结一下今天的笔记"},
    stream=True,
)
reply = ""
for line in resp.iter_lines(decode_unicode=True):
    if line.startswith("data: ") and '"type": "text"' in line:
        reply += json.loads(line[6:])["content"]
print(reply)

会话说明

• 每个 Token 一份独立会话，与微信 / 飞书以及其它 Token 互不影响。
• 上下文范围遵循「AI 机器人」页的 消息上下文 配置。
• 发送 /new 可清空上下文、开新对话，与聊天渠道同语义。