Generate AI Avatar Photos

Learn how to create customized AI avatar photos using HeyGen's API. 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

See detailed API reference
Use this endpoint to generate AI photo avatars with customizable attributes. The following attributes are required to define the avatar's look: age, gender, ethnicity, orientation, pose, style, appearance.

curl --location '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"
  }
}

Check Generation Status

See detailed API reference
Track the progress of your avatar photo generation using the following endpoint:

curl --request GET \
     --url https://api.heygen.com/v2/photo_avatar/generation/4ea4fea89c724fcfb49502c4323bac55 \
     --header 'accept: application/json' \
     --header 'x-api-key: <your_api_key>'

{
    "error": null,
    "data": {
        "id": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "in_progress",
        "msg": null,
        "image_url_list": null,
        "image_key_list": null
    }
}

{
    "error": null,
    "data": {
        "id": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "success",
        "msg": null,
        "image_url_list": [
            "https://resource2.heygen.ai/image/701c1dfb977d4d62bef3fda755e2d4c5/original",
            "https://resource2.heygen.ai/image/605e0f207d7b4c2c92923dda0d480583/original",
            "https://resource2.heygen.ai/image/97c92a578a824a2083947285f8b80e4e/original",
            "https://resource2.heygen.ai/image/2632443cb8394276b8d3046ea6748f47/original"
        ],
        "image_key_list": [
            "image/701c1dfb977d4d62bef3fda755e2d4c5/original",
            "image/605e0f207d7b4c2c92923dda0d480583/original",
            "image/97c92a578a824a2083947285f8b80e4e/original",
            "image/2632443cb8394276b8d3046ea6748f47/original"
        ]
    }
}

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