请求参数
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。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY,使用控制台创建的 API Key。 |
Content-Type | application/json(URL)或 multipart/form-data(文件) |
上传文件时,由请求库自动设置 Content-Type 和 boundary,不要手动指定。
计费
¥0.005×倍率/次
提交时按 1 倍预扣,后台在任务完成后自动结算。查询状态、获取结果和下载不另收费。