DeckFlow Logo 开发者 DeckFlow 文档
开始使用
开发者指南API 参考MCPCLI

合并与拆分器

合并与拆分器 API 规格和任务参数，支持合并多个 PPTX 文件、将 HTML 页面打包为独立播放器、或拆分 PPTX 演示文稿。

API 接口

合并与拆分任务为异步处理。使用以下两个接口进行任务创建与结果获取。点击右侧的“调试接口”可打开交互式控制台。

POST /tools/tasks

创建一个异步的合并或拆分任务。表单参数中 type 值对应相应的工具 ID。

GET /tools/tasks/:id

查询合并/拆分任务的执行状态，并在完成后通过 result.url 获取最终输出的下载链接。

请求头

请求头 类型 是否必填 描述
Authorization String 是 Bearer <YOUR_API_KEY> — 您的开发者 API 密钥。
Content-Type String 是 (POST) 必须为 multipart/form-data。

POST 请求体参数 (Form Data)

参数名 类型 是否必填 描述
files File 是 待处理的源文件。支持上传多个文件。pptx.join 需要至少 2 个文件。
type String 是 任务类型标识符。例如：pptx.join。
params String (JSON) 否 包含工具特定参数的 JSON 字符串。默认为空 JSON 字符串 "{}"。
notifyURL String 否 Webhook 回调 URL，用于接收任务状态更新通知。

任务参数说明

PPTX Merger (PPTX 合并)

按顺序将多个 PPTX 文件合并为一个演示文稿。支持 .pptx 格式，每个文件大小限制为 300 MB。文件上传的顺序决定了合并幻灯片的顺序。params 为空对象 {}。

HTML Player Pack (网页播放器打包)

将多个独立的 HTML 幻灯片打包为一个统一的、美观的网页播放器环境，并带有内置的导航控制。支持 .html and .htm 格式，每个文件大小限制为 50 MB。params 的结构如下：

{
  "contents": [{}, {}],       // array of objects。是否必填。长度和顺序必须与上传文件的顺序相匹配
  "pageWidth": 1280,          // number。播放器画布宽度分辨率（像素）
  "pageHeight": 720,          // number。播放器画布高度分辨率（像素）
  "title": "Presentation",    // string。播放器中显示的主演示文稿标题
  "description": "Details",   // string。播放器中显示的副标题或简短描述
  "brandMarkPosition": "none" // string。品牌 Logo 的位置，默认为 "none"
}

PPTX Splitter (PPTX 拆分)

将多页 PPTX 文件拆分为独立的单页 PPTX 演示文稿。支持 .pptx 格式，文件大小限制为 300 MB。params 为空对象 {}（完成后，输出将是一个包含所有拆分后单页 PPTX 文件的 ZIP 压缩包）。