为什么开放 API
妙音的定位是「内容 Agent」：你提需求，Agent 跑完采集、生产、分发、数据回流的整条流水线，你只在手机上审批。
但很多团队已经有自己的系统——内部 CMS、数据看板、飞书/钉钉机器人、自动化脚本。OpenAPI v1 让这些系统也能驱动妙音：你的程序可以拉走数据做二次分析，也可以反向提交内容需求，让 Agent 在你的工作流里跑。
现在开放的 6 个接口
| 方法 | 路径 | 用途 | |---|---|---| | GET | /api/v1/me | 账号概要（验证 Key 是否有效） | | GET | /api/v1/topics | 选题清单（支持按状态、品牌筛选） | | GET | /api/v1/manuscripts | 稿件列表 + 各渠道发布状态 | | GET | /api/v1/manuscripts/{id} | 稿件详情（含完整正文） | | GET | /api/v1/effects?days=30 | 效果回采：查看 / 点赞 / 回复 / 分享 | | POST | /api/v1/directives | 提交内容需求指令 |
几个关键设计：
- 数据隔离：每个 Key 只能访问自己账号（租户）的数据，跨账号查询一律返回 404
- 提交指令不直接扣费：通过 API 提交的指令会进入「待确认」状态，你在控制台确认后才走正常计费流程——防止程序写错把单元刷光
- Key 安全存储：服务端只存哈希，完整 Key 只在生成时显示一次，丢了只能重置（旧 Key 立即失效）
3 分钟上手指引
第 1 步：生成 Key
登录控制台 → 左侧栏底部点「我的」→ 找到「OpenAPI（开发者）」卡片 → 点「开通并生成 API Key」→ 立即复制保存（只显示这一次）。
第 2 步：验证 Key
```bash curl -H "Authorization: Bearer svt_你的Key" \ https://sarasvati.cn/api/v1/me ```
返回你的账号信息就说明通了。
第 3 步：拉数据 / 提需求
拉最近稿件（含各渠道发布状态）：
```bash curl -H "Authorization: Bearer svt_你的Key" \ "https://sarasvati.cn/api/v1/manuscripts?limit=10" ```
拉最近 30 天效果数据：
```bash curl -H "Authorization: Bearer svt_你的Key" \ "https://sarasvati.cn/api/v1/effects?days=30" ```
提交一条内容指令（进控制台待确认，不扣单元）：
```bash curl -X POST -H "Authorization: Bearer svt_你的Key" \ -H "Content-Type: application/json" \ -d '{"brandId": 1, "content": "本周给品牌出 3 篇行业热点图文，发知乎和公众号"}' \ https://sarasvati.cn/api/v1/directives ```
典型用法
- 数据看板：每天定时拉 /effects，把阅读、点赞、回复汇进你自己的 BI
- 稿件归档：稿件审批发布后，用 /manuscripts/{id} 拉完整正文存进你的内容库
- 外部触发：你的监控系统发现行业热点 → 自动 POST /directives → 妙音 Agent 开始干活 → 你手机上收到审批短信
后续规划
- 发布操作类接口（指定渠道直接发布 / 重新发布）
- Webhook 回调（稿件待审批、发布完成、效果更新主动推送给你的系统）
- 更细粒度的 Key 权限（只读 / 读写分离）
有接口需求欢迎在控制台「工单」里提，被采纳有单元奖励。
— 妙音内容团队