概览智能PPT API 直连方案的能力地图、接口分组、常规流程与阅读路径。
智能PPT API 直连方案适合有研发团队、希望把 PPT 生成与处理能力深度接入现有业务系统的客户。接入时，你不需要先理解所有接口细节，先建立“接口分组”和“常规链路”的整体认知，会更容易完成落地。
| 能力分类 | 代表接口 | 解决什么问题 |
|---|---|---|
| 生成类 | /apps/ppt-create / /apps/ppt-create-file / /apps/ppt-create-thesis | 根据主题、文件、论文等内容发起 PPT 生成 |
| 结构预处理类 | /apps/ppt-structure / /apps/ppt-cover | 先确认目录结构、封面方案，再进入正式生成 |
| 结果查询类 | /apps/ppt-result | 查询任务进度、状态、预览和交付前置信息 |
| 交付类 | /apps/ppt-download / /apps/ppt-editor | 下载 PPT 或进入在线编辑器 |
| 增强类 | 演讲稿、插页、动画、字体、套版等接口 | 在已有 PPT 基础上继续增强和编辑 |
| 公共服务类 | 余额查询、状态码 | 统一处理配额、状态与异常返回 |
所有 API 调用前，建议先完成以下准备：
Authorization: Bearer {token}。id 的持久化存储。这一组文档用于建立接入认知，帮助你先跑通最短闭环：
这一组接口负责“从 0 到 1”发起 PPT 任务：
| 场景 | 文档 | 对应能力 |
|---|---|---|
| 一句话主题、长文本生成 | 输入文字主题生成 | 最常见主入口 |
| 上传 PDF / Word 等文件生成 | 上传文件生成（PDF / Word） | 适合已有材料 |
| 学术答辩生成 | 答辩论文生成 | 适合论文答辩场景 |
| 先确认大纲再生成 | 自定义大纲生成 | 适合企业审核场景 |
| Markdown 结构直接生成 | Markdown 大纲生成 | 适合内容结构已明确的场景 |
| 企业品牌模板生成 | 企业模板生成 | 适合品牌统一交付 |
这一组更适合在主流程跑通后再接入：
这组接口几乎是所有生成链路的必经环节：
| 文档 | 接口 | 作用 |
|---|---|---|
| 任务状态查询与结果获取 | /apps/ppt-result | 查询进度、状态、预览和结果 |
| 导出与下载 | /apps/ppt-download | 获取下载地址 |
| 打开编辑器 | /apps/ppt-editor | 获取编辑器地址 |
| 余额查询 / 状态码 | 通用接口 | 统一处理配额和异常返回 |
这组接口用于“已有 PPT 之后”的增强处理：
大多数 API 直连项目都遵循下面这条标准链路：
选择一个生成入口
-> 创建任务并返回 id
-> 查询 /apps/ppt-result
-> 任务完成后下载 PPT 或进入编辑器
-> 按需继续做演讲稿、插页、动画、字体等增强处理如果你只想先跑通一条最短闭环，推荐从基础接入示例流程开始。
输入文字主题生成
-> 查询任务结果
-> 下载 PPT上传文件生成
-> 查询任务结果
-> 下载或进入编辑器AI 标题大纲生成 / 自定义大纲生成
-> 人工确认结构
-> 正式创建 PPT
-> 查询结果并交付先完成生成主流程
-> 打开编辑器
-> 添加演讲稿 / 插入单页 / 调整样式id，不要把创建成功直接当成生成完成。