Skip to main content
A look is one outfit/pose/style for a character (avatar group). It’s the value you pass as avatar_id to video creation. List via GET /v3/avatars/looks, fetch one via GET /v3/avatars/looks/{look_id}, or Update / Delete your own. To create a new look, see Create Avatar.

List looks

Filter with group_id (one character’s looks), avatar_type and ownership (public for HeyGen presets, private for your own). Results are paginated: when has_more is true, pass next_token as token for the next page. The reference lists every parameter and field. Fields worth knowing:
  • id: the value to pass as avatar_id to POST /v3/videos or POST /v3/video-agents.
  • supported_api_engines: the engine values this look accepts for POST /v3/videos, from "heygen-avatar-6", "heygen-avatar-6-turbo", "avatar_iii", "avatar_iv" and "avatar_v". Requesting an engine that isn’t listed returns invalid_parameter.
  • status: training status, processing, completed or failed. Present for private avatars only.

Avatar Types

The avatar_type field determines what features and parameters are available when creating a video:

Get a Single Look

Full schema: GET /v3/avatars/looks/{look_id}. To rename a look, use PATCH /v3/avatars/looks/{look_id}; to remove, DELETE.

Using a Look in Video Creation

Once you have a look id, pass it as avatar_id. When you request a specific rendering engine, pick one from the look’s supported_api_engines array — for example, pass "engine": {"type": "heygen-avatar-6"} for Avatar 6 when the array includes "heygen-avatar-6". Omitting engine uses Avatar IV. See Models for how the engines compare.