路径参数
task_idstring必填提交任务响应中的
data.task_id。替换请求路径中的{task_id}，无需请求体。
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.task_id | string | 任务编号。 |
data.status | string | PENDING、RUNNING、SUCCESS 或 FAILED。 |
data.progress | string | 处理进度；暂不可用时为空字符串。 |
data.error | string | 任务失败时的错误原因。 |
请求说明
使用提交任务时的 API Key：Authorization: Bearer YOUR_API_KEY。本接口适用于异步文档解析、异步格式转换和异步文本翻译。
HTTP 200 OK 表示状态查询成功，任务是否完成由 data.status 决定。响应只包含任务状态与进度，结果请使用获取任务结果接口。查询免费。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY，使用控制台创建的 API Key。 |
任务状态
| data.status | 含义 | 下一步 |
|---|---|---|
PENDING | 等待处理 | 稍后再次查询 |
RUNNING | 正在处理 | 继续查询同一任务 |
SUCCESS | 已完成 | 获取任务结果 |
FAILED | 处理失败 | 读取 data.error，停止轮询 |
状态值区分大小写。可自行设置查询间隔和等待上限，例如每 2 秒查询一次。停止等待不会取消任务，保留任务 ID 后可以继续查询，无需重新提交。