Generate AI Avatar Photos

Learn how to create customized AI avatar photos using HeyGen. These avatars can be personalized with attributes such as age, gender, ethnicity, pose, style, and appearance. Once generated, these avatars can be used to create new groups or looks for further customization.

Generate AI Avatar Photo

Use the Generate Photo Avatar Photos endpoint to generate AI photo avatars with customizable attributes. The following attributes are required to define the avatar's look: name,age, gender, ethnicity,orientation, pose, appearance. For example, the following request creates a realistic AI avatar of a young woman walking through a city street using these parameters.

curl --request POST 'https://api.heygen.com/v2/photo_avatar/photo/generate' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>' \
--data '{
  "name": "Lina",
  "age": "Young Adult",
  "gender": "Woman",
  "ethnicity": "Asian American",
  "orientation": "horizontal",
  "pose": "half_body",
  "style": "Realistic",
  "appearance": "A stylish East Asian Woman in casual attire walking through a bustling city street"
}'

{
  "error": null,
  "data": {
    "generation_id": "def3076d2c8b4929acf269d8ea6b562e"
  }
}

For complete details on all request parameters and response fields, see the Generate Photo Avatar Photos API reference.

Check Generation Status

Track the progress of your avatar photo generation using the Check Photo/Look Generation Status endpoint, using the generation_id provided in the response of the Generate Photo Avatar API.

The response will include a status field that indicates the current state of the generation process. You can view complete status response examples on the right-side Response panel of the API Reference page - open the Examples dropdown to view responses for different video statuses. You can select any example to preview the corresponding response body.

Status Descriptions

in_progress
The look is still being generated.

success
The look has been successfully generated and includes the generated image URLs.

failed
The generation process did not complete successfully.

We have generated our AI Avatar photos, now we can use the image_key to create new avatar groups and looks.