logo
On this page

Drive Digital Human By Action


Description

Through this API, you can make the digital human perform a specified action.

Request prototype

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

Request Parameters

The following request parameter list only shows the API request parameters and some common parameters. For the complete list of common parameters, please refer to Accessing Server APIs - Common Request Parameters.

ParameterTypeRequiredDescription
TaskIdStringYesDigital human video stream task ID. You can obtain it from the response parameters of the CreateDigitalHumanStreamTask API.
ActionStringYesAction name. You can obtain it from the response parameters of the GetDigitalHumanInfo API.

Sample request

  • Request URL:

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

    {
        "TaskId": "46fb5334-628a-4792-8854-d6c4c0cce6c7",
        "Action": "shake_hands"
    }

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.

Sample response

{
    "Code": 0,
    "Message": "success",
    "RequestId": "d799c85c-10c8-4191-8c6a-3290a5940b5f"
}

Previous

Create Digital Human Video Stream Task

Next

Drive Digital Human By Audio