调用 QueryMediaRecordAsyncTask 接口，使用 CreateMediaRecordAsyncTask 接口返回的 TaskId 查询数字人口播视频是否生成完成。任务成功时，接口返回生成的视频 URL。任务失败或超时时，接口返回用于排查原因的错误码和错误信息。

使用说明 #

视频生成需要一定时间。调用本接口后，请根据返回的 Status 执行后续操作：

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

注意事项 #

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

请求说明 #

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

调试 #

请求参数 #

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

Query #

Body #

返回参数 #

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

请求示例 #

POST https://live.volcengineapi.com?Action=QueryMediaRecordAsyncTask&Version=2026-04-01
{
    "TaskId": "8f14e45f-ceea-46****c4c-3b4a7d5d6e11"
}

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "QueryMediaRecordAsyncTask",
        "Version": "2026-04-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "Status": "succeeded",
        "VideoUrl": "https://tos-avatar-upload-bucket-private.tos-cn-beijing.volces.com/2121369266/record/xxx.mp4?X-Tos-Signature=xxx",
        "ErrorCode": "",
        "ErrorMessage": ""
    }
}

错误码 #

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