编辑大纲
接入前提
获取调用 API 所需的 token 请参考 API 鉴权
用户在自研页面修改大纲后,用本接口把大纲树或 Markdown 保存回当前任务。只查看大纲时不需要调用保存接口。
接入方可以提交两类内容:
| 内容形态 | 适合场景 |
|---|---|
| 大纲树 JSON | 已使用 获取大纲数据结构 并在页面中编辑树形结构 |
| Markdown 大纲 | 自研页面直接编辑 Markdown 内容 |
调用时机
| 目标 | 是否使用本接口 |
|---|---|
| 保存用户修改后的大纲树 | 是 |
| 保存用户修改后的 Markdown 大纲 | 是 |
| 仅查看大纲数据结构 | 否,使用 获取大纲数据结构 |
| 导出大纲文件 | 否,使用 导出大纲、完整内容 |
保存成功时响应为 code = 0,保存结果应与提交的 taskId 属于同一任务。
可保存的内容
| 接口描述 | API编辑大纲接口, 参数 content 需要根据任务类型去传对应的值: 1. 智能生成(任务类型1 非联网模式), 需要传修改过的完整大纲数据 2. 其他类型, 需要传修改过的完整大纲+内容数据 | ||
| 接口地址 | /api/ai/chat/v2/outline/save | 请求方式 | POST |
| 权限校验 | 是 | 请求参数 | json |
请求参数
请求示例
文本生成PPT树形结构接口返回数据data下内容的修改后的json字符串
ts
curl --location --request POST 'https://co.aippt.cn/api/ai/chat/v2/outline/save' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>' \
--data-urlencode 'content={"children":[{"children":[],"depth":2,"direction":1,"expanded":true,"id":2,"pageIndex":2,"parentId":1,"showTip":false,"sort":0,"type":"catalog","value":"目录"},{"children":[],"depth":2,"direction":1,"expanded":true,"id":3,"pageIndex":3,"parentId":1,"showTip":false,"sort":1,"type":"ending","value":"结语"}],"depth":1,"direction":1,"expanded":true,"id":1,"index":0,"lastLevel":true,"pageIndex":1,"parentId":0,"showTip":false,"sort":0,"type":"title","value":"哈哈#嘿嘿嘿#嘻嘻嘻嘻-正文1-正文2"}' \
--data-urlencode 'task_id=<taskId>'content 为 Markdown 大纲
ts
curl --location --request POST 'https://co.aippt.cn/api/ai/chat/v2/outline/save' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>' \
--form 'content="# 2026 年第一季度经营复盘
## 核心指标
- 营收完成率 96%,同比增长 12%
- 新增付费客户 318 家
## 主要问题
- 华东区域交付周期超出目标 3 天
- 续费提醒覆盖率不足 80%
## 下季度动作
- 调整华东交付排期
- 补齐续费提醒和负责人看板"' \
--form 'task_id="<taskId>"' \
--form 'type="1"'响应内容
响应示例
ts
{
"code": 0,
"data": 3,
"msg": "success"
}保存结果后续调用
保存成功后,接入方可以继续调用生成内容、获取大纲数据结构或 作品生成。如果保存后的大纲结构不符合预期,请先检查 content 与 task_id 是否匹配同一个任务。
