API
How to guides

Generate a Digital Human Video

4min

Pre-requisites

You have already Created Your First Digital Human prior generating a video of talking Digital Human.

Generate a Video

All Digital Humans, regardless of their operation mode, can be used used to generate a video (in mp4 format) by providing text and voice as the input.

To generate an mp4 video with a Digital Human speaking, the following request is needed against the POST head/text-to-video endpoint:

Curl
JSON


Once the above request is made, you need to fetch the videos from from the GET /head/talks/{id} endpoint. For example:

Curl


The parameters available are listed below:

Name

Description

order

string(query)

--, ASC, DESC

page

number(query)

Pagination, use if you intend to retrieve a large list of videos

take

number(query)

Number of text-to-videos to retrieve

voice

string(query)

Voice you want to be used for the voice; see List Voices

id (required)

string(path)

headID used to generate the video



Creating a playback Digital Human

Digital Humans deployed with operationMode:"ttt" as defined in Operation Mode Parameters, has the added benefit of giving you a Digital Human UI with a Digital Human ready to repeat any text you pass it.

To create a Text-To-Video Digital Human, follow the instructions in Create a Digital Human with "operationMode": "ttt", as shown below

JSON


Response

JSON