v1 · 基础认证 + 转写推送 + 分析读取
认证
所有 /api/v1/* 接口需在请求头携带 API Key：
Authorization: Bearer lj_live_xxxxxxxxxxxxxxxx
API Key 在 创建。
POST /api/v1/transcripts
推送转写文本（适用：硬件设备、第三方录音工具 webhook）
请求
curl -X POST https://shennao.zaowuyun.com/api/v1/transcripts \
-H "Authorization: Bearer lj_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"text": "说话人1: ...\n说话人2: ...",
"title": "周三战略会议",
"device_id": "meeting-room-shanghai-01"
}'响应
{
"transcript_id": "550e8400-e29b-41d4-a716-446655440000",
"analysis_id": null,
"message": "转写已保存"
}GET /api/v1/analyses
列出 org 的最近分析（50 条）
curl https://shennao.zaowuyun.com/api/v1/analyses \ -H "Authorization: Bearer lj_live_xxxxxxxx"
GET /api/v1/analyses?id=xxx
获取分析详情（含证据锚点）
curl "https://shennao.zaowuyun.com/api/v1/analyses?id=ANALYSIS_ID" \ -H "Authorization: Bearer lj_live_xxxxxxxx"
POST /api/v1/ask
问你的第二大脑。系统自动判断走快答（一次性 RAG）还是深度检索（智能体多步翻文档），SSE 流式返回。
curl -N -X POST https://shennao.zaowuyun.com/api/v1/ask \
-H "Authorization: Bearer lj_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"question": "上次客户的核心顾虑是什么？我们答应了什么？",
"projectId": "可选：限定某个项目",
"mode": "auto"
}'SSE 事件：mode（走了哪条路）/ tool_call·tool_result（智能体翻阅过程）/ sources（溯源原子）/ token（流式答案）/ insufficient / done / error。
data: {"type":"mode","mode":"agent"}
data: {"type":"tool_call","tool":"search_atoms","args":{"query":"客户 顾虑"}}
data: {"type":"tool_result","tool":"search_atoms","result":"[#1] (人物判断) …"}
data: {"type":"token","delta":"客户的核心顾虑集中在…"}
data: {"type":"done"}接入第二大脑（MCP）
把你的第二大脑暴露成 MCP Server，任何支持 MCP 的智能体（Claude 桌面端 / Cursor 等）都能直接把你的组织知识当工具调用。
MCP endpoint：https://shennao.zaowuyun.com/api/mcp（用你的 API key 鉴权 · 需 brain.ask 权限）
提供以下工具：
ask_brain(question, project_id?)— 问大脑——完整智能体，多步翻文档后给带溯源的答案search_brain(query, project_id?)— 语义搜索沉淀的洞察原子list_decisions(project_id?)— 列出决策与行动项及状态ingest_transcript(text, title?)— 反向摄取——把对话转写直接投喂进深脑（需 transcript.write 权限）
典型场景：钉钉/飞书里的机器人收到会议转写后，调 ingest_transcript 直接送进你的第二大脑；之后在深脑里分析、沉淀、可被问到。
Claude Code
claude mcp add --transport http deepbrain https://shennao.zaowuyun.com/api/mcp \ --header "Authorization: Bearer lj_live_xxxxxxxx" # 装上「怎么用深脑」的预装 skill（先说处境再检索、只引已核验原话、结果要写回） mkdir -p .claude/skills/deepbrain && curl -fsSL https://shennao.zaowuyun.com/api/mcp/skill -o .claude/skills/deepbrain/SKILL.md
Claude Desktop（claude_desktop_config.json）
{
"mcpServers": {
"deepbrain": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://shennao.zaowuyun.com/api/mcp",
"--header", "Authorization: Bearer lj_live_xxxxxxxx"]
}
}
}Cursor（.cursor/mcp.json）
{
"mcpServers": {
"deepbrain": {
"url": "https://shennao.zaowuyun.com/api/mcp",
"headers": { "Authorization": "Bearer lj_live_xxxxxxxx" }
}
}
}配置后重启客户端，就能对它说「查下我深脑里关于 X 客户的判断」，它会调用你的第二大脑。
限流
每分钟 60 次请求 / API Key（超出返回 429）
权限 (scopes)
transcript.write— 推送转写transcript.read— 取回素材原文，供其他 agent 二次分析（写权限自动包含读权限）analysis.read— 读分析brain.ask— brain.ask —— 问大脑 / 检索（用于 /api/v1/ask 与 MCP）*— 全部
错误码
| 状态码 | 含义 |
|---|---|
| 401 | Key 无效 / 已撤销 |
| 403 | Key 缺少所需权限 |
| 404 | 资源不存在 |
| 429 | 限流 |
| 500 | 服务异常 |
支持
问题反馈：hi@zaowuyun.com