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.
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.
RequestResponse
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"
}
}
See detailed API reference Track the progress of your avatar photo generation using the following endpoint:
RequestResponse (In Progress)Response (Success)
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.
If you often open multiple tabs and struggle to keep track of them, Tabs Reminder is the solution you need. Tabs Reminder lets you set reminders for tabs so you can close them and get notified about them later. Never lose track of important tabs again with Tabs Reminder!
Try our Chrome extension today!
Share this article with your
friends and colleagues.
Earn points from views and
referrals who sign up.
Learn more