Query Running Digital Human Video Stream Tasks
2026-03-20
Description
Through this API, you can query currently running Digital Human video stream tasks.
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
No API request parameters. For the common parameter list, please refer to API Calling Methods - Common Request Parameters.
Request Example
https://aigc-digitalhuman-api.zegotech.cn?Action=QueryDigitalHumanStreamTasks
&<common-request-parameters>Response Parameters
| Parameter | Type | Description |
|---|---|---|
| Code | Number | Return code. 0 indicates success, other values indicate failure. For error codes and response handling recommendations, please refer to Return Codes. |
| Message | String | Description of the request result. |
| RequestId | String | Request ID. |
| Data | Object | Response data. |
| └TaskList | Array of Object | List of currently running Digital Human video stream tasks. For details, refer to Task. |
Task
| Parameter | Type | Description |
|---|---|---|
| TaskId | String | Digital Human video stream task ID. |
| RoomId | String | Room ID of the Digital Human video stream task. The room ID passed when creating the Digital Human video stream task. |
| StreamId | String | Stream ID of the Digital Human video stream task. The stream ID passed when creating the Digital Human video stream task. |
| Status | Number | Task status:
|
| CreateTime | Number | Unix timestamp (seconds) when the task was created. |
Response Example
{
"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
}
]
}
}