Skip to content

查询:任务结果

概览

  • 接口:查询任务结果(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_codestatus_msg
  • video_width, video_height:视频分辨率信息(若返回)。

说明

  • 若接口返回 file_id,请使用对应的下载接口获取视频文件地址。
  • 返回结构可能会根据不同模型或场景略有不同,请以实际返回为准。