拼装版 API / AIPPT OPEN PLATFORM

API 业务流程图

从任务创建到交付导出的最短链路。本页保留官方文档的结构化内容,并补充适合快速浏览的接入视觉地图。

来源:AIPPT 开放平台公开文档打开官方页面(在新标签页打开)
AiPPT 开放平台标志API 链路
请求任务交付

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

基础联调流程

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

主流程

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

辅助能力

能力使用时机相关接口
高级配置创建任务或生成前读取接入方可用配置获取高级配置
模板选择需要让用户选择系统模板或企业模板时模板
预置词需要生成主题建议、示例主题或运营推荐时预置词
额度查询需要展示用户剩余额度、统计消耗或做运营控制时获取用户大纲次数