请求参数
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 用于标识产物,不代表还需要等待异步处理。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY,使用控制台创建的 API Key。 |
Content-Type | application/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 或请求失败时不收费。