智能PPT API 接口说明

智能PPT API 直连方案适合有研发团队、希望把 PPT 生成与处理能力深度接入现有业务系统的客户。接入时，你不需要先理解所有接口细节，先建立“接口分组”和“常规链路”的整体认知，会更容易完成落地。

能力地图

接入前准备

所有 API 调用前，建议先完成以下准备：

1. 阅读企业认证 & Token 获取方式。
2. 确认服务端能稳定携带 Authorization: Bearer {token}。
3. 在业务系统中预留任务 id 的持久化存储。

接口分组

1. 导读与流程

这一组文档用于建立接入认知，帮助你先跑通最短闭环：

• 基础接入示例流程：先理解标准链路如何跑通。
• 异步接口说明：理解为什么返回的是任务 id。
• 本页下方的“生成入口怎么选”：判断不同场景该从哪个生成入口开始。
• 二次处理与辅助能力：理解生成完成后还能做什么。

2. 生成接口

这一组接口负责“从 0 到 1”发起 PPT 任务：

3. 扩展生成接口

这一组更适合在主流程跑通后再接入：

• 更多生成方案
• AI 标题大纲生成
• 模板封面生成
• 绘图 PPT 生成

4. 结果与交付接口

这组接口几乎是所有生成链路的必经环节：

5. 增强接口

这组接口用于“已有 PPT 之后”的增强处理：

• PPT 二次处理
• 插入PPT单页
• 添加PPT演讲稿

生成入口怎么选

这一部分只解决一个问题：不同生成场景应该从哪个创建接口开始。

所有创建接口在成功后都会返回任务 id，后续统一进入结果查询链路。完整处理方式请继续参考基础接入示例流程。

典型选择方式

1. 想最快接入一条主流程

• 先选 POST /apps/ppt-create
• 最适合先验证主题生成是否符合预期
• 适合大多数首次联调场景

2. 已经有原始材料文件

• 选 POST /apps/ppt-create-file
• 适合直接基于 PDF、Word、TXT 等已有内容生成
• 更适合资料已经沉淀好的客户

3. 场景明确是论文答辩

• 选 POST /apps/ppt-create-thesis
• 适合对答辩结构、章节表达有专门要求的场景

4. 客户必须先确认结构

• 先走 POST /apps/ppt-structure
• 客户确认大纲后再走 POST /apps/ppt-create
• 更适合企业汇报、方案类、需要人工审核的项目

5. 强调品牌统一和模板复用

• 选 POST /apps/ppt-company-create
• 适合企业模板、品牌资产、标准化交付要求更强的客户

创建接口返回后优先关注什么

大多数创建接口在成功返回后，建议优先关注以下结果：

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "任务ID"
  }
}

data.id 不代表最终成品地址，而是后续查询、下载、编辑和增强处理时需要持续使用的任务标识。

常规接入流程

大多数 API 直连项目都遵循下面这条标准链路：

选择一个生成入口
-> 创建任务并返回 id
-> 查询 /apps/ppt-result
-> 任务完成后下载 PPT 或进入编辑器
-> 按需继续做演讲稿、插页、动画、字体等增强处理

如果你只想先跑通一条最短闭环，推荐从基础接入示例流程开始。

常见业务组合

快速主题生成

输入文字主题生成
-> 查询任务结果
-> 下载 PPT

文件材料生成

上传文件生成
-> 查询任务结果
-> 下载或进入编辑器

企业审核式生成

AI 标题大纲生成 / 自定义大纲生成
-> 人工确认结构
-> 正式创建 PPT
-> 查询结果并交付

生成后继续编辑

先完成生成主流程
-> 打开编辑器
-> 添加演讲稿 / 插入单页 / 调整样式

接入建议

• 第一次联调时，不要同时接全部接口，先跑通一条主流程。
• 先完成“创建 -> 查询 -> 下载”的最短闭环，再接编辑器和增强能力。
• 业务系统中一定要保存任务 id，不要把创建成功直接当成生成完成。
• 如果项目需要人工审核内容结构，优先考虑先出大纲再正式生成。
• 如果你要做企业交付，模板生成通常比纯文本生成更容易被接受。

推荐阅读顺序

1. 先看本页，了解接口分组和整体结构。
2. 再看基础接入示例流程，跑通标准接入链路。
3. 如果不理解任务模式，再看异步接口说明。
4. 按场景进入对应生成接口文档。
5. 主流程稳定后，再评估编辑器与增强接口。