查询:任务结果
概览
- 接口:查询任务结果(GET /task/{task_id})
- 说明:用于查询异步生成任务的处理状态与结果,先调用生成接口获取
task_id,再使用该接口查询结果。
认证
- 使用 Bearer Token(在请求头
Authorization: Bearer <token>中传入)。
请求参数
Path 参数:
task_id(string, 必填)- 任务 ID,先执行异步任务以获取该 ID,然后用此接口查询任务状态与结果。
返回说明
返回 Content-Type:
application/json重要字段:
code(integer):业务返回码,0 表示成功(示例中常见)。data(object):任务数据,包含:status(string):任务状态,例如Success/Processing/Failed。resp_data(string):响应数据(结构可能随场景不同)。video_url(string):视频下载地址(注:有时需要使用file_id再调用下载接口获取地址)。image_urls:图片列表(若无则可能为null)。binary_data_base64(array[string]):二进制数据的 base64 列表(若有)。
status(integer):HTTP 风格的状态码(示例字段,按实际返回为准)。message(string):消息描述。request_id(string):请求 ID,用于排查问题。time_elapsed(string):耗时信息。
成功响应示例
(示例保留原文)
json
{
"status": "Success",
// 最终需要根据file_id 使用下载接口 获取视频地址。
"file_id": "314053136425242",
"task_id": "314052875571396",
"base_resp": {
"status_msg": "success",
"status_code": 0
},
"video_width": 768,
"video_height": 1152
}字段说明
file_id(string):当返回文件 id 时,可使用下载接口根据file_id获取最终视频地址。task_id(string):任务 ID。base_resp(object):基础返回信息,包含status_code与status_msg。video_width,video_height:视频分辨率信息(若返回)。
说明
- 若接口返回
file_id,请使用对应的下载接口获取视频文件地址。 - 返回结构可能会根据不同模型或场景略有不同,请以实际返回为准。