提交焕新任务 (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 地址。 |