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
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 asavatar_idtoPOST /v3/videosorPOST /v3/video-agents.supported_api_engines: the engine values this look accepts forPOST /v3/videos, from"heygen-avatar-6","heygen-avatar-6-turbo","avatar_iii","avatar_iv"and"avatar_v". Requesting an engine that isn’t listed returnsinvalid_parameter.status: training status,processing,completedorfailed. Present for private avatars only.
Avatar Types
Theavatar_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 lookid, 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.

