DeckFlow Logo 开发者 DeckFlow 文档
开发者指南 API 参考 MCP CLI

提交焕新任务 (Revamp)

升级演示文稿排版、配色以及品牌 DNA,同时保留幻灯片的原始文本内容。

接口规格说明

创建一个异步的幻灯片焕新任务。表单参数中 type 值必须固定为 revamp。

POST /tools/tasks

请求头

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

POST 请求体参数 (Form Data)

参数名 类型 是否必填 描述
spaceId String 否 目标工作空间 Space ID。
files File 是 待焕新的演示文稿文件(支持 PPTX 格式),支持上传多个文件。
type String 是 任务类型。固定值:revamp。
name String 否 任务显示名称,例如 "AI 焕新文档任务"。
params String (JSON) 是 包含焕新参数的 JSON 字符串。详细字段如下。

任务参数说明 (params)

在 params JSON 字符串内部支持的参数字段:

字段 类型 是否必填 描述
inputText String 否 排版风格指南、配色规则或品牌 DNA 说明,用于指导幻灯片焕新设计。
advancedModel Boolean 否 是否使用高级设计推理 AI。默认值:false。
fastMode Boolean 否 是否优先开启快速模式。默认值:false。
notifyURL String 否 任务状态变更通知的回调 Webhook 地址。