logo
On this page

Query Running Digital Human Video Stream Tasks


Description

通过本接口,您可以查询当前正在运行中的数字人视频流任务。

Request prototype

  • Request method: POST
  • Request body format: JSON
  • Request URL: https://aigc-digitalhuman-api.zegotech.cn?Action=QueryDigitalHumanStreamTasks
  • Transmission protocol: HTTPS
  • QPS limit: 10 times/second

Request Parameters

This API has no parameters other than common parameters. For the complete list of common parameters, please refer to Accessing Server APIs - Common Request Parameters ## Sample request

https://aigc-digitalhuman-api.zegotech.cn?Action=QueryDigitalHumanStreamTasks
&<Common Request Parameters>

Response parameters

ParameterTypeDescription
CodeNumberReturn code. 0 indicates success, other values indicate failure. For error codes and response handling suggestions, please refer to Return Codes.
MessageStringDescription of the request result.
RequestIdStringRequest ID.
DataObjectReturn data.
└TaskListArray of ObjectList of running digital human video stream tasks. For details, please refer to Task.

Task

ParameterTypeDescription
TaskIdStringDigital human video stream task ID.
RoomIdStringRoom ID of the digital human video stream task. The room ID passed in when calling the CreateDigitalHumanStreamTask API.
StreamIdStringStream ID of the digital human video stream task. The stream ID passed in when calling the CreateDigitalHumanStreamTask API.
StatusNumberTask status:
  • 1: Video stream task initializing.
  • 3: Stream publishing.
CreateTimeNumberUnix timestamp (seconds) when the task was created.

Sample response

{
    "Code": 0,
    "Message": "success",
    "RequestId": "ec0881f7-9e62-4e74-a66c-f31579c42f92",
    "Data": {
        "TaskList": [
            {
                "TaskId": "688bd608-823d-4830-b469-fb7fb1c5dbbe",
                "RoomId": "room_8176",
                "StreamId": "789856",
                "CreateTime": 1750298304,
                "Status": 3
            }
        ]
    }
}

Previous

Interrupt Digital Human Video Stream Drive Task

Next

Stop Digital Human Video Stream Task