View Digital Human Details

2026-03-20

Description

Through this API, you can obtain detailed information about a Digital Human.

Request prototype

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

Request Parameters

The following request parameter list only includes API request parameters and some common parameters. For the complete list of common parameters, please refer to API Calling Methods - Common Request Parameters.

Parameter	Type	Required	Description
DigitalHumanId	String	Yes	Digital Human ID. You can obtain it from the response of the GetDigitalHumanList API.

Request Example

Request URL:

https://aigc-digitalhuman-api.zegotech.cn?Action=GetDigitalHumanInfo
&<common-request-parameters>

https://aigc-digitalhuman-api.zegotech.cn?Action=GetDigitalHumanInfo
&<common-request-parameters>

Request body:

{
    "DigitalHumanId": "fa592895-d988-4584-b27b-97b8f4b921ad"
}

{
    "DigitalHumanId": "fa592895-d988-4584-b27b-97b8f4b921ad"
}

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.
└DigitalHumanId	String	Digital Human ID.
└Name	String	Digital Human name.
└AvatarUrl	String	Digital Human image URL. The access validity period is 24 hours.
└IsPublic	Boolean	Whether it is a public Digital Human.
└Actions	Array of Object	List of actions supported by the Digital Human. For details, refer to Action.

Action

Parameter	Type	Description
Action	String	Action name.
PreviewUrl	String	Action preview video URL.

Response Example

{
    "Code": 0,
    "Message": "success",
    "RequestId": "52ef286e-0ee5-4cbb-ba93-45c4f89c5d00",
    "Data": {
        "DigitalHumanId": "fa592895-d988-4584-b27b-97b8f4b921ad",
        "Name": "xxx",
        "AvatarUrl": "https://xxx.com/xxx.png",
        "Actions": [
            {
                "Action": "802_921474",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "790_421367",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "804_750085",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "idle_action",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "mute_action",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            }
        ],
        "IsPublic": true
    }
}

{
    "Code": 0,
    "Message": "success",
    "RequestId": "52ef286e-0ee5-4cbb-ba93-45c4f89c5d00",
    "Data": {
        "DigitalHumanId": "fa592895-d988-4584-b27b-97b8f4b921ad",
        "Name": "xxx",
        "AvatarUrl": "https://xxx.com/xxx.png",
        "Actions": [
            {
                "Action": "802_921474",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "790_421367",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "804_750085",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "idle_action",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            },
            {
                "Action": "mute_action",
                "PreviewUrl": "https://xxx.com/preview/xxx/xxx.mp4"
            }
        ],
        "IsPublic": true
    }
}