> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Avatar V

> Avatar V is HeyGen's highest-fidelity v3 rendering engine, using cross-reference-driven animation for the most natural motion and lip-sync. Opt-in per look.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-3.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=c8191ba4743fd85050f1af1a93ed4969)

## Supported avatar types

`digital_twin`, `studio_avatar`, and `photo_avatar` looks that list `avatar_v` in `supported_api_engines`.

## Supported parameters

* `motion_prompt` — natural-language control of body motion and hand gestures.
* `engine.reference_look_id` *(optional)* — a `digital_twin` look to use as the animation reference. Must belong to the same avatar group as `avatar_id`, and a non-public one must clear its group's consent requirements. When omitted, a digital twin or studio avatar references itself, and a photo avatar uses an eligible look from its group. A photo avatar with no eligible look renders directly from its image, and `motion_prompt` is then rejected.
* `engine.more_blinking` *(optional)*: set to `true` for more natural blinking. Defaults to `false`.

For `expressiveness` control, use [Avatar IV](https://heygen-1fa696a7.mintlify.site/avatar-iv.md).

## Checking eligibility

Avatar V is opt-in per look. Fetch the look with [`GET /v3/avatars/looks/{look_id}`](https://heygen-1fa696a7.mintlify.site/reference/get-avatar-look): Avatar V is available when `"avatar_v"` appears in its `supported_api_engines`.

## Example request

Select Avatar V by passing `"engine": { "type": "avatar_v" }` in your [`POST /v3/videos`](https://heygen-1fa696a7.mintlify.site/reference/create-video) request:

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/videos" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "avatar",
    "avatar_id": "YOUR_LOOK_ID",
    "script": "Hello from Avatar V.",
    "voice_id": "YOUR_VOICE_ID",
    "resolution": "1080p",
    "engine": { "type": "avatar_v" }
  }'
```

Video generation is asynchronous — the response returns a `video_id` you poll with `GET /v3/videos/{video_id}`. See the [Digital Twin guide](https://heygen-1fa696a7.mintlify.site/generate-avatar-video.md) for the end-to-end request and polling flow, [Models](https://heygen-1fa696a7.mintlify.site/models) for an engine comparison, or [Avatar IV](https://heygen-1fa696a7.mintlify.site/avatar-iv.md) for the default engine.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.