提交生成任务 (Generation)

使用复杂文档、文本提示词或网页链接生成专业的演示文稿幻灯片 (PPTX)。

接口规格说明

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

POST /tools/tasks

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

参数名	类型	是否必填	描述
`spaceId`	`String`	否	目标工作空间 Space ID。
`files`	`File`	否	参考的源文档文件（支持 PDF、Word 或 Markdown），支持上传多个文件。
`type`	`String`	是	任务类型。固定值：`generation`。
`name`	`String`	否	任务显示名称，例如 `"AI 生成文档任务"`。
`params`	`String (JSON)`	是	包含任务参数的 JSON 字符串。详细字段如下。

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

字段	类型	是否必填	描述
`inputText`	`String`	否	用于构建幻灯片结构的主题描述、网页链接 URL 或原始文本。
`enableSearch`	`Boolean`	否	是否启用网页搜索以研究并丰富内容细节。默认值：`false`。
`advancedModel`	`Boolean`	否	是否使用深度推理 AI 模型，以获得更好的逻辑排版和更具创意的幻灯片。默认值：`false`。
`fastMode`	`Boolean`	否	是否开启快速模式，优先输出排版速度而非极致的细节优化。默认值：`false`。
`intent`	`String`	否	自定义目标意图或指示。
`audience`	`String`	否	目标受众特征，用于指导 AI 选择幻灯片布局和文案风格。
`pageCount`	`Integer`	否	需要生成的幻灯片页数/目标页数。
`author`	`String`	否	生成 PPTX 文件元数据中的作者署名。
`notifyURL`	`String`	否	任务状态变更通知的回调 Webhook 地址。

请求头 Authentication

Authorization string required

以 Authorization 头传递的 Bearer 令牌：

Body 参数 multipart/form-data

spaceId string

工作空间 Space ID。

files file

上传本地源参考文档。

否 file chosen

type string required

任务类型，固定值：generation。

name string

生成任务的显示名称。

notifyURL string

Webhook 回调 URL，用于接收状态变更回调通知。

params json string required

包含生成参数的 JSON 字符串。