API 业务流程图
拼装版(API 版本)由接入方自行实现业务页面,通过开放 API 完成认证、创建任务、按任务类型准备内容、处理大纲、生成作品和导出文件。模板、企业模板和专业布局参数在作品生成时确定,并随 /api/design/v2/save 一起提交。
主流程
| 阶段 | 关键动作 | 相关接口 |
|---|---|---|
| 接入准备 | 通过 AK/SK 签名获取 token,后续 API 请求统一传入 x-api-key、x-token 和 x-channel | 鉴权、API 公共约定 |
| 创建任务 | 创建生成任务并保存 taskId,后续生成、查询、作品处理都围绕该任务继续 | 任务创建 |
| 标题生成 | 先获取大纲,再通过 ticket 查询内容生成结果 | 智能生成 |
| 文档、链接、联网、单页生成 | Word 类、参考文档、URL、联网、单页生成完成后进入 PPT 树结构处理 | 上传 Word、上传参考文档、导入 URL 链接、联网智能生成、单页生成 |
| XMind、Freemind、Markdown 文件 | 调用 /api/ai/conver/file 解析为 Markdown 内容,再进入 PPT 树结构处理 | 上传普通文件 |
| Markdown 粘贴、预置词 | 创建任务后内容已在任务中,不调用 /api/ai/conver/file;可获取 PPT 树结构并编辑,也可直接选择模板生成作品 | 任务创建、预置词 |
| 大纲处理 | 获取可用于合成的大纲树,必要时编辑并保存大纲内容 | 获取大纲数据结构、编辑大纲 |
| 作品处理 | 作品生成时选择模板、企业模板和可选专业布局,并进行列表、详情、重命名、删除、回收站等管理 | 模板、作品、回收站 |
| 交付导出 | 导出 PPTX,或按需导出大纲、完整内容文件 | 作品导出、作品导出结果、导出大纲、完整内容 |
辅助能力
| 能力 | 使用时机 | 相关接口 |
|---|---|---|
| 高级配置 | 创建任务或生成前读取接入方可用配置 | 获取高级配置 |
| 模板选择 | 需要让用户选择系统模板或企业模板时 | 模板 |
| 预置词 | 需要生成主题建议、示例主题或运营推荐时 | 预置词 |
| 额度查询 | 需要展示用户剩余额度、统计消耗或做运营控制时 | 获取用户大纲次数 |
