文档中心
数字人 PaaS 服务
服务端 API
实时流式视频合成
查询驱动任务状态

查询驱动任务状态

更新时间：2025-04-15 19:16

描述

调用本接口查询一个驱动任务的状态。

接口原型

请求方法：POST
中国大陆正式环境请求地址：https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanLiveDriver
传输协议：HTTPS
调用频率限制：10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数，公共参数列表请参考调用方式 - 公共请求参数。

参数	类型	是否必选	描述
TaskId	String	仅 DriverTaskId 为空时，必填	数字人视频流任务 ID，创建数字人视频流任务后返回。
DriverTaskId	String	仅 TaskId 为空时，必填	驱动数字人任务 ID，驱动数字人后返回。

请求示例

请求 URL

https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanLiveDriver
&AppId=1234567890
&SignatureNonce=15215528852396
&Timestamp=1234567890
&Signature=7a2c0f11145fb760d607a07b54825013
&SignatureVersion=2.0

请求消息体

{
    "TaskId": "your_task_id",
    "DriverTaskId": "your_driver_rtask_id"
}

响应参数

参数	类型	描述
Code	Int	错误码。
Message	String	错误描述。
Data	Object	响应对象。
TaskId	String	数字人视频流任务 ID。
RoomId	String	房间 ID。
StreamId	String	数字人音视流 ID。
LiveDriverDataList	Array of Object	驱动数据。
DriverTaskId	String	驱动直播任务 ID。
Status	Int	驱动任务状态： 1：排队中。 2：驱动中。 3：驱动失败。 4：驱动结束。 5：驱动中断（被打断）。 6：驱动音频结束。
Duration	Number	驱动时长。
Deduction	Number	扣费时长，具体抵扣系数请发送邮件至 aigc@zego.im 获取。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "TaskId": "5b14dfba-d6b1-4013-b0a6-829e130e4937",
        "RoomId": "your_room_id",
        "StreamId": "your_stream_id",
        "LiveDriverDataList": [
            {
                "DriverTaskId": "45799a25-f2c4-4fe5-a9f6-aa2dc41c2808",
                "Status": 4,
                "Duration": 100,
                "Deduction": 210
            }
         ]
    }
}

返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
0	成功。	-
100000004	签名过期。	请重新生成签名。
100000005	签名错误。	请确认生成签名的参数是否正确。
400000001	输入参数无效。	请根据 Message 提示，调整对应参数的取值。
400000002	数字人 PaaS 服务权限未开通。	请联系 ZEGO 技术支持开通服务权限。
400000005	未找到任务。	请确认设置的 TaskId 是否正确。
400010000	系统错误。	请联系 ZEGO 技术支持处理。