说明不同生成入口的适用场景,以及创建接口与后续异步查询链路之间的关系。
这一页只解决一个问题:不同生成场景应该从哪个创建接口开始。
所有创建接口在成功后都会返回任务 id,后续统一进入结果查询链路。完整处理方式请先参考基础接入示例流程。
| 场景 | 推荐接口 | 什么时候最适合 |
|---|---|---|
| 一句话主题、长文本、Markdown | POST /apps/ppt-create | 最常见,适合大多数业务接入 |
| 已有 PDF / Word / TXT 等材料 | POST /apps/ppt-create-file | 希望直接基于已有文件生成 |
| 学术答辩、论文演示 | POST /apps/ppt-create-thesis | 需要论文答辩专用结构 |
| 先出大纲,再确认生成 | POST /apps/ppt-structure + POST /apps/ppt-create | 企业客户、人工审核场景更友好 |
| 使用企业模板或品牌资产 | POST /apps/ppt-company-create | 强调品牌统一与模板复用 |
| 绘图风格、封面、模板扩展 | 参考“更多生成方案” | 已跑通主流程后再接更稳妥 |
POST /apps/ppt-createPOST /apps/ppt-create-filePOST /apps/ppt-create-thesisPOST /apps/ppt-structurePOST /apps/ppt-createPOST /apps/ppt-company-create大多数创建接口在成功返回后,建议优先关注以下结果:
{
"code": 200,
"msg": "success",
"data": {
"id": "任务ID"
}
}data.id 不代表最终成品地址,而是后续查询、下载、编辑和增强处理时需要持续使用的任务标识。