HEheygen
Avatars

List Look Templates

Changed on

Lists the look templates and Look Packs your workspace can apply with POST /v3/avatars/looks. Send an item's id as template_id and its type as type. Filter by gender to match your avatar.

get/v3/avatars/look-templates

Request

  • Base URL
    https://api.heygen.com
  • URL
    https://api.heygen.com/v3/avatars/look-templates
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Query parameters

type'look_pack' | 'template'

Filter by generation method: 'look_pack' for Look Packs, 'template' for single look templates. Omit for both.

gender'male' | 'female'

Filter to templates built for 'male' or 'female'. Templates with no gender of their own are returned for either value. Omit for all.

limitinteger

Maximum number of items to return per page (1-50).

tokenstring

Opaque cursor token for the next page.

Response

Successful response

has_moreboolean

Whether more pages are available

next_tokenstring nullable

Opaque cursor for the next page

Example response

{
  "data": [
    {
      "id": "5a8e6be843ee4321a014946bf62aa322",
      "name": "Modern Corporate",
      "preview_image_url": "https://resource2.heygen.ai/avatar_remix_template/modern_corporate_female/profile.png",
      "looks_count": 5
    }
  ]
}

Changes