格式转换

提交后返回任务编号,通过独立接口查询状态并获取结果。

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

请求参数

filebinary与另一输入二选一

通过 multipart/form-data 上传文件内容。

urlstring与另一输入二选一

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

target_formatstring必填

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

qualityinteger可选

有损图片的质量,整数 1–100。其他目标格式可省略。

output_namestring可选

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

返回字段

data.task_idstring

任务编号。

请求说明

提交成功返回 HTTP 202 和 data.task_id。使用查询任务状态查看进度。完成后从获取任务结果取得下载地址,也可携带同一 API Key 调用 GET /v1/convert/{task_id}/download。

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

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

计费

¥0.005×倍率/次

提交时按 1 倍预扣,后台在任务完成后自动结算。查询状态、获取结果和下载不另收费。