优化器

优化器 API 规格和任务参数，支持文件压缩、图像尺寸修改、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`。

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

减小办公文档和压缩包的文件大小，同时最大化视觉质量。支持 .zip、.pptx、.key、.docx、.xlsx 格式，文件大小限制为 300 MB。params 为空对象 {}。

在保持原始宽高比的同时自定义调整图像大小。支持 image/* 格式，文件大小限制为 100 MB。params 结构如下：

{
  "maxWidth": 800,   // number。可选。以像素限制最大宽度（与 maxHeight 互斥）
  "maxHeight": 600   // number。可选。以像素限制最大高度（与 maxWidth 互斥）
}

将外部字体直接嵌入到 PPTX 演示文稿中，以解决因缺少系统字体而导致的格式差异。支持 .pptx 格式，文件大小限制为 300 MB。params 结构如下：

{
  "usedFonts": ["Inter", "Roboto"] // array of strings。从 Google Fonts 字体库中需要嵌入的字体家族名称数组
}

高效压缩视频文件大小以减少带宽占用。支持 video/*（如 MP4、MOV 等常用格式），文件大小限制为 300 MB。params 为空对象 {}。

请求头 Authentication

Authorization string required

通过 Bearer token 传递的访问令牌。在此输入您的密钥：

请求体参数 multipart/form-data

files file required

选择待处理的源文件。

未选择文件

type select required

优化器工具标识符。

notifyURL string optional

Webhook 回调 URL，用于接收任务状态更新通知。

params json string

自定义参数，必须为 JSON 字符串。

路径参数 URL 路径

id string required

任务的 UUID 标识。