调用 ListMediaRecordAsyncTasks 接口，查看当前账号创建的数字人口播视频生成任务，获取各任务的处理状态以及生成的视频 URL。支持按任务状态筛选，结果按任务创建时间倒序排列。

使用说明 #

• 需要批量查看任务时，调用本接口。已知 TaskId 且只需查询单个任务时，调用 QueryMediaRecordAsyncTask 接口。
• 根据 Status 处理任务：
  • init 或 queued：任务正在初始化或排队，可稍后再次调用本接口查询。
    • running：任务正在处理，可稍后再次调用本接口查询。如果处理时长达到 15 分钟仍未成功，状态将变为 failed。此前 init 和 queued 阶段的耗时不计入处理时长。
    • succeeded：任务处理成功，无需继续查询。通过 VideoUrl 获取生成的视频。每次调用本接口查询都会返回一个指向同一视频的新临时访问链接，链接有效期为 3 天，请及时下载或转存视频。
    • failed 或 timeout：任务处理失败或超时，无需继续查询。通过 ErrorCode 和 ErrorMessage 排查原因。

注意事项 #

• 请求频率：单用户请求频率限制为 10 次/秒。
• 前提条件：已调用 CreateMediaRecordAsyncTask 接口生成数字人口播视频任务。

请求说明 #

• 请求方式：POST
• 请求地址：https://live.volcengineapi.com?Action=ListMediaRecordAsyncTasks&Version=2026-04-01

调试 #

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query #

Body #

返回参数 #

下表仅列出本接口特有的返回参数。更多信息请见返回结构。

Tasks #

请求示例 #

POST https://live.volcengineapi.com?Action=ListMediaRecordAsyncTasks&Version=2026-04-01
{
    "Status": "succeeded",
    "PageNumber": 1,
    "PageSize": 20
}

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListMediaRecordAsyncTasks",
        "Version": "2026-04-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "Tasks": [
            {
                "TaskId": "8f14e45f-ceea-467a-9c4c-3b4a7d5d6e11",
                "Status": "succeeded",
                "VideoUrl": "https://tos-avatar-upload-bucket-private.tos-cn-beijing.volces.com/2121369266/record/xxx.mp4?X-Tos-Signature=...",
                "ErrorCode": null,
                "ErrorMessage": null
            }
        ],
        "Total": 37,
        "PageNumber": 1,
        "PageSize": 20
    }
}

错误码 #

您可访问公共错误码，获取更多错误码信息。