Skip to content

编辑大纲

接入前提

获取调用 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"
}

保存结果后续调用

保存成功后,接入方可以继续调用生成内容、获取大纲数据结构或 作品生成。如果保存后的大纲结构不符合预期,请先检查 contenttask_id 是否匹配同一个任务。