路径参数
task_idstring必填提交任务响应中的
data.task_id。替换请求路径中的{task_id},无需请求体。
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.task_id | string | 任务编号。 |
data.status | string | 已完成任务为 SUCCESS。 |
data.progress | string | 处理进度。 |
data.result.sources | object | 文件名称与下载 URL 的映射,文件类任务成功时返回。 |
data.result.text | string | 翻译任务成功时返回的译文。 |
data.result.usage.multiplier | number | 实际用量倍率,0 表示零用量。任务未上报倍率时省略该字段,并保留预扣费用。 |
全部结果.zip 为完整归档,也可能列出单个文件。文件名称和数量以实际响应为准。
请求说明
先通过查询任务状态确认 data.status 为 SUCCESS,再调用本接口。使用提交任务时的 API Key:Authorization: Bearer YOUR_API_KEY。
HTTP 200 OK 表示查询成功。从 data.result.sources 读取“文件名称 → 下载 URL”的映射;异步翻译直接读取 data.result.text,没有文件。任务尚未完成时不返回 result,应继续查询状态。后台在任务完成后自动结算。获取结果和下载免费,实际扣费金额见任务记录。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY,使用控制台创建的 API Key。 |
下载文件
复制 data.result.sources 中需要的完整 URL,保留签名参数后直接下载,无需附加 API Key。将下例地址替换为接口实际返回的 URL。
bash
curl --fail-with-body --location \
"https://api.zleap.com/v1/tasks/task_example/artifacts/archive/content?access=SIGNED_ACCESS" \
--output task-result.zip
如果返回相对路径,使用 API 请求的同一域名补全。签名地址失效时,重新调用本接口获取新地址,无需重新提交任务。
正文保存在下载文件中。文档解析的 .octx 文档包可解压后读取 knowledge/main.md。