格式转换

转换文档和图片格式,预览并下载处理后的文件。

POSThttps://api.zleap.com/v1/tools/convert同步接口
调用方式

请求参数

filebinary与另一输入二选一

通过 multipart/form-data 上传一个非空文件,最大 50 MiB;部署可能设置更低上限。

urlstring与另一输入二选一

公开可访问的完整 HTTP(S) 地址,不能包含用户名或密码。

target_formatstring必填

目标扩展名,1–12 个字母或数字,可带前导点,大小写会标准化。支持的转换组合取决于输入文件类型。

output_namestring可选

输出文件名。缺少扩展名时自动补充,扩展名不匹配时替换为目标格式。

返回字段

filenamestring

转换后的文件名。

content_typestring

结果的媒体类型。

sizeinteger

结果文件的字节数。

target_formatstring

目标格式。

task_idstring

用于标识转换产物;转换已经完成,无需轮询任务状态。

download_urlstring

已完成转换的文件下载地址;若为相对路径,拼接当前 API 基础地址。携带同一把 API Key 请求该地址。

resultstring

与 download_url 指向同一产物的绝对平台地址;转换已完成,携带同一 API Key 下载。

usage.multipliernumber

本次消耗倍率,保留两位精度。

请求说明

同步接口。 请求完成后返回 HTTP 200 OK,响应包含文件信息和 download_url。用同一把 API Key 请求这个下载地址即可获取文件,无需轮询任务状态。

响应中的 task_id 用于标识产物,不代表还需要等待异步处理。

必填请求头取值
AuthorizationBearer YOUR_API_KEY,使用控制台创建的 API Key。
Content-Typeapplication/json(URL)或 multipart/form-data(文件)

上传文件时,由请求库自动设置 Content-Type 和 boundary,不要手动指定。

格式选择

根据输入文件类型选择目标格式。文件后缀、实际编码和媒体类型可能不同,不能只改名作为转换结果。

下载产物

收到 HTTP 200 后,携带同一把 API Key GET 响应中的 result,直接下载文件。也可把相对路径 download_url 与平台域名组合。结果已生成,无需轮询,下载不重复计费。

上传文件或提交 URL

file 与 url 二选一。上传文件使用 multipart/form-data,由请求库生成 boundary;URL 输入可使用 JSON 或 multipart。单文件最大 50 MiB,部署可能设置更低上限。

计费

¥0.005×倍率/次

上传文件和 URL 转换使用同一基础价,按基础价 × 响应的 usage.multiplier 结算。倍率为 0 或请求失败时不收费。