API 业务流程图

拼装版 API 由接入方自己实现页面和状态流转。最短链路是：鉴权、创建任务、准备内容、处理大纲、生成作品、导出文件。模板和专业布局在作品生成时选择，不在任务创建时选择。

基础联调流程

关注点	阅读方式
第一次联调	先按“接入准备 → 创建任务 → 标题生成 → 大纲处理 → 作品处理 → 交付导出”跑通最短路径
多输入来源	Word、参考文档、URL、联网生成、单页生成都属于内容准备分支，完成后再进入大纲或作品处理
作品生成	模板、企业模板和专业布局在作品生成阶段确定，不在任务创建阶段确定
结果交付	PPTX 导出走作品导出；Markdown 或完整内容文件走大纲/内容导出

阶段	关键动作	相关接口
接入准备	通过 AK/SK 签名获取 `token`，后续 API 请求统一传入 `x-api-key`、`x-token` 和 `x-channel`	API 鉴权、API 公共约定
创建任务	创建生成任务并保存 `taskId`，后续生成、查询、作品处理都围绕该任务继续	任务创建
标题生成	先获取大纲，再通过 `ticket` 查询内容生成结果	智能生成
文档、链接、联网、单页生成	Word 类、参考文档、URL、联网、单页生成完成后进入 PPT 树结构处理	上传 Word、上传参考文档、导入 URL 链接、联网智能生成、单页生成
XMind、Freemind、Markdown 文件	调用 `/api/ai/conver/file` 解析为 Markdown 内容，再进入 PPT 树结构处理	上传普通文件
Markdown 粘贴、预置词	创建任务后内容已在任务中，不调用 `/api/ai/conver/file`；可获取 PPT 树结构并编辑，也可直接选择模板生成作品	任务创建、预置词
大纲处理	获取可用于合成的大纲树，必要时编辑并保存大纲内容	获取大纲数据结构、编辑大纲
作品处理	作品生成时选择模板、企业模板和可选专业布局，并进行列表、详情、重命名、删除、回收站等管理	模板、作品、回收站
交付导出	导出 PPTX，或按需导出大纲、完整内容文件	作品导出、作品导出结果、导出大纲、完整内容