异步接口说明

智能PPT的大多数生成接口都不是“请求一次，立即返回成品文件”，而是先创建任务，再围绕任务 id 持续推进。

先记住这 3 件事

1. 大部分生成类接口先返回的是任务 id，不是成品链接。
2. 查询进度、下载、进入编辑器、二次修改，几乎都围绕同一个 id 展开。
3. 真正稳定的产品接入方式一定包含轮询结果这一层。

标准模型

生成任务 -> 返回 id -> 查询结果 -> 下载 / 编辑 / 增强操作

为什么这样设计

生成 PPT 往往涉及：

• 内容结构生成
• 版式与模板渲染
• 图片与资源处理
• 文件导出与编辑器资源准备

所以系统把提交任务和交付结果拆成了两个阶段。

id 的意义

• 它不是一次性的回执号，而是整条任务链路的主键。
• 后续查询结果、下载文件、进入编辑器、做增强处理，都会继续使用这个 id。
• 如果业务系统不保存这个 id，后续能力就无法稳定串起来。

status 怎么理解

推荐前端表达

特殊模式：report=true

在标准创建接口中传入 report=true，会更偏向先进入编辑器，再等待渲染完成的链路。

这页不解决什么问题

• 不负责比较不同生成入口该怎么选
• 不负责展开下载、编辑器、增强接口的细节
• 不负责代替完整主流程说明

如果你要跑通完整链路，请继续看基础接入示例流程。