查询任务状态

接口地址: GET /task/status/{taskId}

接口描述: 查询批量任务的执行状态和子任务进度

需要认证: 是

请求参数

路径参数:

参数名	类型	位置	必需	描述
taskId	String	Path	是	批量任务ID（UUID格式）

响应结果

成功响应:

{
    "success": true,
    "code": 200,
    "message": "操作成功",
    "data": {
        "taskId": "ec617e1996174c129a872680fa27078e",
        "status": "processing",
        "message": "任务进度: 3/4 已完成, 0 失败",
        "totalItems": 4,
        "completedItems": 3,
        "failedItems": 0,
        "createdAt": 1769757913000,
        "completedAt": null,
        "subTaskList": [
            {
                "subTaskId": "4124831",
                "prompt": "请帮我搜索最新款 iPhone型号，以及 iOS 版本",
                "platform": "doubao",
                "mode": "reasoning_search",
                "status": "completed"
            },
            {
                "subTaskId": "4124832",
                "prompt": "请帮我搜索最新款 iPhone型号，以及 iOS 版本",
                "platform": "yuanbao",
                "mode": "search",
                "status": "completed"
            },
            {
                "subTaskId": "4124833",
                "prompt": "请帮我推荐一款只能手机",
                "platform": "doubao",
                "mode": "reasoning_search",
                "status": "processing"
            },
            {
                "subTaskId": "4124834",
                "prompt": "请帮我推荐一款只能手机",
                "platform": "yuanbao",
                "mode": "search",
                "status": "completed"
            }
        ]
    }
}

响应字段说明:

字段名	类型	描述
taskId	String	批量任务ID
status	String	任务状态，详见下方状态说明
message	String	任务进度描述
totalItems	Integer	子任务总数
completedItems	Integer	已完成数量
failedItems	Integer	失败数量
createdAt	Long	创建时间戳（毫秒）
completedAt	Long	完成时间戳（毫秒）
subTaskList	Array	子任务列表

任务状态值:

状态值	描述
pending	任务已创建，等待开始执行
processing	任务执行中
completed	任务全部完成且无失败
partial_completed	任务部分完成，有成功也有失败
failed	任务全部失败

轮询建议

建议每 5-10 秒轮询一次状态接口，避免过于频繁的请求。当 status 为 completed、partial_completed 或 failed 时，可以获取最终结果。