# Add Looks to Photo Avatar Group
Adds additional looks (images) to an existing photo avatar group.
**Note:**
* The `image_url` field returns a time-limited link that expires after 7 days. The image itself does not get deleted, only the link expires. To ensure continuous access, you have two options:
1. **Download the Image:** Save the image locally within the 7-day window.
2. **Regenerate the URL:** Call the endpoint again whenever you need to access the image. Each time you call the endpoint, the `Expires` and related query parameters in the URL are regenerated, reflecting the new expiration time.
* Scroll down to the **Response** section below and expand the status code(s) to view the detailed response schema.
* Refer to the **RESPONSE** section on the right and choose an example to see how the API response appears for each status code.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "heygen-api",
"version": "4.0.8"
},
"servers": [
{
"url": "https://api.heygen.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"name": "x-api-key",
"in": "header",
"x-default": ""
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v2/photo_avatar/avatar_group/add": {
"post": {
"summary": "Add looks to photo avatar group",
"description": "Add other looks to existing photo avatar group",
"operationId": "add-looks-to-photo-avatar-group",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"group_id": {
"type": "string",
"description": "Unique identifier of the avatar group to which the new looks will be added. Can be retrieved from the Create Photo Avatar Group endpoint."
},
"image_keys": {
"type": "array",
"description": "Image key(s) of the AI-generated avatar(s)/uploaded photo(s) to add to the avatar group. For AI-generated avatars, this can be retrieved from the Check Photo/Look Generation Status endpoint. For user-uploaded photos, this can be retrieved from the Upload Asset endpoint. A maximum of 4 images can be added at a time.",
"items": {
"type": "string"
}
},
"name": {
"type": "string",
"description": "Name of the look. "
},
"generation_id": {
"type": "string",
"description": "Unique identifier of the AI-generated avatar. Can be retrieved from the Generate Photo Avatar Photos endpoint. _Applies only to the AI avatar photos._"
}
},
"required": [
"group_id",
"image_keys",
"name"
]
}
}
}
},
"responses": {
"200": {
"description": "Look added successfully - Expand to view the detailed response schema.",
"content": {
"application/json": {
"examples": {
"Result": {
"value": {
"error": null,
"data": {
"photo_avatar_list": [
{
"id": "cp0832b516144500a10ea1562aa75vbd",
"image_url": "https://files2.heygen.ai/photo_generation/a3a2415eaeb84b6291d0722f33bd898c/45919a20-52e6-414b-ade5-071adfe88add.jpg?Expires=1761028611&Signature=HC5b9dLWg6gA9dod3PgpbZ3rDmZgfHzwx0e43XKN8kCUlrNKa8lYdEPWflYRS5Par~xSexb3hHJL2gmVALeBsmOYTQfG2ETNkGJWJM8F3K5oKkiuPoqJcnvq-ifLukwMsPA0zKMrQOMxKVAo2O27J7rK8rnYb1sFVNEfOMz~ss9HYBYMbkxAcu-ay4lNZ4X2Nw634S25rYAQwlAgsvZB~qN9tpZ3PkuuYmvqQh-pN7YUGYHaaY6wLabLd-KOBd9vyDev7V46kaxx3dpZzlIMzzJ~aDcayfPPqSb2Wni-GidSK~nSSeqHYHn6kwbU0VvwdoJZCZcTSz5FrnEbJpKO1g__&Key-Pair-Id=K38HBHX5LX3X2H",
"created_at": 1760423811.58612,
"name": "Dua Casual",
"status": "pending",
"group_id": "5981377fb29c4aa4baeb49b8e4d73252",
"is_motion": false,
"motion_preview_url": null,
"business_type": "generated",
"upscale_availability": {
"available": false,
"reason": "Photo avatar look upload not completed"
},
"upscaled": false,
"background_sound_effect": null,
"default_voice_id": null,
"moderation_msg": null
},
{
"id": "9321e7ee184243dc9b3f7v5b31722119",
"image_url": "https://files2.heygen.ai/photo_generation/a3a2455eaeb94b6291d07c2f33bd898c/c527682a-c13f-4988-92a9-e2f30f1e5115.jpg?Expires=1761028612&Signature=GMjoEMLagOUOuFrnumt~24bsox1wBDAqKqgfkOIBZcRYQkqtDilq5AWm~gJLKoxwyku1dw6b3rhpNBvFeCz-yZgLb8W5vNKZO7dBKddNhzVPoJakCBdsPANM47Xaur6XmCEgLSwTC8dAzuawwU7moWnY238JGsDN4n~NdSVBWLKuoL1pmse7iSWkw1MTTRIHNpKXCMz3QgBByQUV1YVVNS2MimRimbemu6lyTntzbjxKYarmOguDmChVo5jaIyTRv9inLQ~op4NGkPczRv61gIMCnfrtGvyfUiU-zllAwIRE2q5tltwvBQmAvtYCL67TvHLrE1KNReP1LqYAhVLGIw__&Key-Pair-Id=K38HBHX5LX3X2H",
"created_at": 1760423812.047471,
"name": "Dua Casual",
"status": "pending",
"group_id": "5981377fb29c4aa4baeb49b8e4d73252",
"is_motion": false,
"motion_preview_url": null,
"business_type": "generated",
"upscale_availability": {
"available": false,
"reason": "Photo avatar look upload not completed"
},
"upscaled": false,
"background_sound_effect": null,
"default_voice_id": null,
"moderation_msg": null
}
]
}
}
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Displays error message when the request fails; null if the request is successful."
},
"data": {
"type": "object",
"properties": {
"photo_avatar_list": {
"type": "array",
"description": "List of looks added to the avatar group. ",
"items": {
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of the look."
},
"image_url": {
"type": "string",
"description": "URL of the look's image."
},
"created_at": {
"type": "integer",
"description": "Unix timestamp when the look was created."
},
"name": {
"type": "string",
"description": "Name of the look. "
},
"status": {
"type": "string",
"description": "Processing status of the look (e.g., \"pending\", \"in_appeal\", \"moderation_rejected\")."
},
"group_id": {
"type": "string",
"description": "Unique identifier of the group the look belongs to."
},
"is_motion": {
"type": "boolean",
"description": "Whether the look is a motion (animated) avatar."
},
"motion_preview_url": {
"type": "string",
"description": "URL of the motion avatar's preview. Returns null if not available."
},
"business_type": {
"type": "string",
"description": "Indicates the origin of the look (e.g., \"generated\" or \"uploaded\")."
},
"upscale_availability": {
"type": "object",
"description": "Information about the look's upscaling availability.",
"properties": {
"available": {
"type": "boolean",
"description": "Whether the look can be upscaled."
},
"reason": {
"type": "string",
"description": "Reason why the look cannot be upscaled (if applicable)."
}
}
},
"upscaled": {
"type": "boolean",
"description": "Whether the look has already been upscaled."
},
"background_sound_effect": {
"type": "string",
"description": "Background sound effect applied to the look. Returns null if none. "
},
"default_voice_id": {
"type": "string",
"description": "Default voice ID assigned to the look. "
},
"moderation_msg": {
"type": "string",
"description": "Message describing the result of content moderation for the look. Provides the reason if the look is rejected, suspended, or pending review. Returns null if no moderation issues exist."
}
},
"type": "object"
}
}
},
"description": "Contains the list of looks. "
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```