Heygen Avatar V Digital Twin
Playground
Try it on WavespeedAI!HeyGen Avatar V Digital Twin is a fast AI avatar video generation model that creates natural digital twin videos from text or audio with lip-sync, optional captions, background removal, and MP4/WebM output. Ready-to-use REST inference API for digital humans, virtual presenters, product explainers, marketing videos, training content, social media clips, and professional avatar video workflows with simple integration, no coldstarts, and affordable pricing.
Features
HeyGen Avatar IV Digital Twin
HeyGen Avatar IV Digital Twin generates a talking avatar video from a selected HeyGen digital twin avatar and an uploaded audio clip. It is designed for presenter videos, spokesperson content, personalized avatar delivery, and other avatar-driven speaking workflows with flexible output controls.
Why Choose This?
-
Digital twin avatar workflow Use a prebuilt digital twin avatar to generate speaking video from audio.
-
Audio-driven speech performance Upload an audio clip to drive the avatar’s timing, expression, and speaking delivery.
-
Flexible framing controls Choose aspect ratio, fit mode, and output resolution to match your target platform.
-
Optional background removal Enable
remove_backgroundfor supported matting-enabled avatars. -
Optional caption export Enable
captionto generate a sidecar SRT subtitle file alongside the video. -
Production-ready API Suitable for personalized presenter videos, internal communications, ads, explainers, and virtual spokesperson workflows.
Parameters
| Parameter | Required | Description |
|---|---|---|
| avatar | Yes | Selected HeyGen digital twin avatar. |
| audio | Yes | Audio clip used to drive the avatar video. |
| fit | No | How the avatar is framed in the output, such as cover. |
| remove_background | No | Remove the avatar background. Requires a matting-enabled avatar. |
| caption | No | Generate a sidecar SRT caption file alongside the video. |
| output_format | No | Output video format. Default: mp4. |
| resolution | No | Output resolution, such as 720p. |
| aspect_ratio | No | Output aspect ratio, such as 16:9. |
How to Use
- Choose your avatar — select the digital twin avatar you want to use.
- Upload your audio — provide the voice track that should drive the avatar.
- Adjust framing (optional) — choose
fit,resolution, andaspect_ratio. - Enable extras (optional) — turn on
remove_backgroundorcaptionif needed. - Submit — run the model and download the generated avatar video.
Example Use Case
Generate a polished office presenter video from a digital twin avatar and a short voice clip for internal announcements or marketing content.
Pricing
Pricing is based on the uploaded audio duration.
| Audio Duration | Cost |
|---|---|
| 5s | $0.60 |
| 6s | $0.72 |
| 7s | $0.84 |
| 8s | $0.96 |
| 10s | $1.20 |
| 15s | $1.80 |
Billing Rules
- Base price is $0.12 per second
- Minimum billed duration is 5 seconds
- Audio duration is rounded up to the next whole second
Best Use Cases
- Digital spokesperson videos — Create branded speaking-avatar content quickly.
- Internal communications — Deliver announcements, updates, and training clips with a consistent avatar.
- Marketing and ads — Produce talking-head promo content without filming.
- Explainers and onboarding — Turn voice scripts into presenter-led video.
- Localized delivery — Reuse the same avatar with different voice tracks and captions.
Pro Tips
- Upload clean audio for better speaking rhythm and lip-sync quality.
- Keep clips short while testing avatar style and framing.
- Use
captionwhen the final video needs accessible subtitles. - Only enable
remove_backgroundif the selected avatar supports matting. - Match
aspect_ratioto your final platform, such as16:9for widescreen delivery.
Notes
avatarandaudioare required.- Billing uses the uploaded audio duration, with a minimum of 5 seconds.
- Audio duration is rounded up to the next whole second before billing.
remove_backgroundrequires a matting-enabled avatar.captiongenerates a sidecar SRT file, not burned-in subtitles.
Related Models
- HeyGen Avatar IV avatar workflows — Useful when you need other avatar generation modes or delivery options.
- Talking avatar video workflows — Useful when you want image-based or non-digital-twin avatar generation instead of a preset HeyGen twin.
- Subtitle and caption workflows — Useful when you need more advanced subtitle styling or burn-in options.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/heygen/avatar-v/digital-twin" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"avatar": "Abigail Sofa Front",
"audio": "",
"fit": "cover",
"remove_background": false,
"output_format": "mp4",
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| avatar | string | Yes | Abigail Sofa Front | Abigail Office Front, Abigail Office Side, Abigail Sofa Front, Abigail Sofa Side, Amelia Business Training Front 2, Amelia Business Training Front, Amelia Business Training Side 2, Amelia Business Training Side, Amelia Lounge Front 2, Amelia Lounge Front, Amelia Lounge Side 2, Amelia Lounge Side, Amelia Yoga Front 2, Amelia Yoga Front, Amelia Yoga Side 2, Amelia Yoga Side, Anja Office Front, Anja Office Side , Anja Sofa Front, Anja Sofa Side , Ann Doctor Sitting, Ann Doctor Standing, Ann Therapist, Annie Bar Sitting Front, Annie Bar Sitting Side, Annie Bar Standing Front 2, Annie Bar Standing Front 3, Annie Bar Standing Front, Annie Bar Standing Side 2, Annie Bar Standing Side 3, Annie Bar Standing Side, Annie Business Casual Standing Front 2, Annie Business Casual Standing Front, Annie Business Casual Standing Side 2, Annie Business Casual Standing Side, Annie Casual Sitting Front 2, Annie Casual Sitting Front, Annie Casual Sitting Side 2, Annie Casual Sitting Side, Annie Casual Standing Front 2, Annie Casual Standing Front, Annie Casual Standing Side 2, Annie Casual Standing Side, Annie Desk Sitting Front 2, Annie Desk Sitting Front, Annie Desk Sitting Side 2, Annie Desk Sitting Side, Annie Lounge Standing Front, Annie Lounge Standing Side, Annie Office Sitting Front 2, Annie Office Sitting Front, Annie Office Sitting Side 2, Annie Office Sitting Side, Annie Office Standing Front, Annie Office Standing Side, Annie Sofa Sitting Front 3, Annie Sofa Sitting Front, Annie Sofa Sitting Side 2, Annie Sofa Sitting Side 3, Annie Sofa Sitting Side, Annie Sofa Sitting Front 2, Annie Studio Pink Sitting Front, Annie Studio Pink Sitting Side, Annie Studio Pink Standing Front, Annie Studio Pink Standing Side, Artur Office Front 2, Artur Office Front, Artur Office Side 2, Artur Office Side, Artur Sofa Casual Front 2, Artur Sofa Casual Front, Artur Sofa Casual Side 2, Artur Sofa Causal Side, Aubrey Sofa Side, Aubrey Night Scene Front, Aubrey Outdoor Sport Front, Aubrey Outdoor Sport Side, Aubrey Sofa Front, Blanka Lounge Front, Blanka Lounge Side, Blanka Outdoor Business Front, Blanka Outdoor Business Side, Blanka Outdoor Reading Front, Blanka Outdoor Reading Side, Blanka Picnic Front, Blanka Picnic Side, Bojan Business Training Front 2, Bojan Business Training Front, Bojan Business Training Side 2, Bojan Business Training Side, Bojan Lounge Front 2, Bojan Lounge Front, Bojan Lounge Side 2, Bojan Lounge Side, Bojan Sport Front 2, Bojan Sport Front, Bojan Sport Side 2, Bojan Sport Side, Brandon Business Sitting Front, Brandon Business Sitting Side, Brandon Business Standing Front, Brandon Business Standing Side, Brandon Casual Sitting Front, Brandon Casual Sitting Side, Brandon Kitchen Standing Front, Brandon Kitchen Standing Side, Brandon Lobby Sitting Front, Brandon Lobby Sitting Side, Brandon Lobby Standing Front, Brandon Lobby Standing Side, Brandon Office Sitting Front, Brandon Office Sitting Side, Brandon Office Standing Front, Brandon Office Standing Side, Brandon Sofa Sitting Front, Brandon Sofa Sitting Side, Brent Office Front 2, Brent Office Front, Brent Office Side 2, Brent Office Side, Brent Sofa Front 2, Brent Sofa Front, Brent Sofa Side 2, Brent Sofa Side, Bryan Fitness Coach, Bryan Tech Expert, Caroline Business Sitting Front, Caroline Business Sitting Side, Caroline Business Standing Front, Caroline Business Standing Side, Caroline Casual Sitting Front, Caroline Casual Sitting Side, Caroline Kitchen Standing Front, Caroline Kitchen Standing Side, Caroline Lobby Sitting Front, Caroline Lobby Sitting Side, Caroline Lobby Standing Front, Caroline Lobby Standing Side, Caroline Office Sitting Front, Caroline Office Sitting Side, Caroline Office Standing Front, Caroline Office Standing Side, Caroline Sofa Sitting Front, Caroline Sofa Sitting Side, Chloe Lounge Front, Chloe Lounge Side, Chloe Outdoor Side, Conrad House Front, Conrad House Side, Conrad Sofa Front, Conrad Sofa Side, Derya Indoor Front 2, Derya Indoor Front, Derya Indoor Side 2, Derya Indoor Side, Derya Office Front 2, Derya Office Front, Derya Office Side 2, Derya Office Side, Dexter Doctor Sitting, Dexter Doctor Standing, Dexter Lawyer, Elenora Fitness Coach, Elenora Fitness Coach 2, Elenora Tech Expert, Emanuel Office Front, Emanuel Office Side, Emanuel Sofa Front, Emanuel Sofa Side, Emilia Outdoor Business Front, Emilia Outdoor Business Side, Emilia Outdoor Yoga Front 2, Emilia Outdoor Yoga Front, Emilia Outdoor Yoga Side, Emilia Picnic Front, Emilia Picnic Side, Edward, Fernando Business Indoor Front, Fernando Business Indoor Side, Fernando OutdoorChair Front 2, Fernando Outdoor Chair Front, Fernando Outdoor Chair Side, Fernando Outdoor Front, Fernando Outdoor Side, Fernando Outdoor Table Front, Fernando Outdoor Table Side, Gala Bedroom Front, Gala Business Sofa Front 2, Gala Business Sofa Front 3, Gala Business Sofa Front, Gala Business Sofa Side 2, Gala Business Sofa Side 3, Gala Business Sofa Side, Gala Casual Sofa with iPad Front, Gala Casual Sofa with iPad Side 2, Gala Casual Sofa with iPad Side, Gala Office Front, Gala Office Side, Gala Sofa Front 2, Gala Sofa Front 3, Gala Sofa Front, Gala Sofa Side 2, Gala Sofa Side 3, Gala Sofa Side, Georgia Casual Front, Georgia Casual Side, Georgia Office Front, Georgia Office Side, Gerardo Sofa Side, Gerardo Indoor Front, Gerardo Indoor Side, Gerardo Night Scene Front 2, Gerardo Night Scene Front, Gerardo Outdoor Sport Front, Gerardo Outdoor Sport Side, Gerardo Sofa Front, Giulia Office Front 2, Giulia Office Front, Giulia Office Side 2, Giulia Office Side, Giulia Sofa Front, Giulia Sofa Side, Giulia Sofa Front 2, Giulia Sofa Side 3, Ida Lounge Front 2, Ida Lounge Front, Ida Lounge Side 2, Ida Lounge Side, Ida Sofa Front 2, Ida Sofa Front, Ida Sofa Side 2, Ida Sofa Side, Jocelyn Office Front 2, Jocelyn Office Front, Jocelyn Office Side 2, Jocelyn Office Side, Jocelyn Sofa Front 2, Jocelyn Sofa Front, Jocelyn Sofa Side 2, Jocelyn Sofa Side, Joel Couch Front, Joel Couch Side, Joel Gym Front, Joel Gym Side, Joel Mountain Front, Joel Mountain Side, Jonas Gym Front 2, Jonas Gym Front, Jonas Gym Side 2, Jonas Gym Side , June Office Front 2, Juan Office Front, Juan Office Side 2, Juan Office Side, Juan Sofa Front 2, Juan Sofa Front, Juan Sofa Side 2, Juan Sofa Side, Judita Yoga Front 2, Judita Yoga Front, Judita Yoga Side 2, Judita Yoga Side, Judy Doctor Sitting, Judy Doctor Standing, Judy Lawyer, Judy Teacher Sitting, Judy HR, Judy Teacher Standing, June HR, June Office Front, June Office Side 2, June Office Side, June Sofa Casual Front 2, June Sofa Casual Front, June Sofa Casual Side 2, June Sofa Casual Side, Kavya Indoor Front, Kavya Indoor Side, Kavya Outdoor Side, Kavya Outdoor Sport Front, Kavya Outdoor Sport Side, Kavya Sofa Front, Kavya Sofa Side, Leos Office Front 2, Leos Office Front, Leos Office Side 2, Leos Office Side, Leos Sofa Front 2, Leos Sofa Front, Leos Sofa Side 2, Leos Sofa Side, Leszek Lounge Front, Leszek Lounge Side, Leszek Outdoor Business Front, Leszek Outdoor Business Side, Leszek Outdoor Casual Front, Leszek Outdoor Casual Side, Leszek Sofa Front, Leszek Sofa Side, Leah, Martina Office Front 2, Martina Office Front, Martina Office Side 2, Martina Office Side, Martina Sofa Front 2, Martina Sofa Front, Martina Sofa Side 2, Martina Sofa Side, Masha Office Front 2, Masha Office Front, Masha Office Side 2, Masha Office Side, Masha Sofa Casual Front 2, Masha Sofa Casual Front, Masha Sofa Casual Side 2, Masha Sofa Casual Side, Matteo Office Front 2, Matteo Office Front, Matteo Office Side 2, Matteo Office Side, Matteo Sofa Front 2, Matteo Sofa Front, Matteo Sofa Side 2, Matteo Sofa Side, Max Indoor Front, Max Indoor Side, Max Outdoor Sport Front, Max Outdoor Sport Side, Milena Office Front 2, Milena Office Front, Milena Office Side 2, Milena Office Side, Milena Sofa Front 2, Milena Sofa Front, Milena Sofa Side 2, Milena Sofa Side, Miles Outdoor Front, Miles Outdoor Side, Miles Sofa Front 2, Miles Sofa Front, Miles Sofa Side 2, Miles Sofa Side, Mireia Business Indoor Front, Mireia Business Indoor Side, Mireia Outdoor Chair Front, Mireia Outdoor Front, Mireia Outdoor Side, Mireia Outdoor Table Front, Mireia Outdoor Table Side, Miyu Office Front 2, Miyu Office Front, Miyu Office Side 2, Miyu Office Side, Miyu Sofa Business Front, Miyu Sofa Business Side, Miyu Sofa Casual Front 2, Miyu Sofa Casual Front, Miyu Sofa Casual Side 2 , Miyu Sofa Casual Side, Noah Lobby Front 2, Noah Lobby Front, Noah Lobby Side 2, Noah Lobby Side, Noah Office Front 2, Noah Office Front, Noah Office Side 2, Noah Office Side, Noah Sofa Front 2, Noah Sofa Front , Noah Sofa Side 2, Noah Sofa Side, Oxana Gym Front 2, Oxana Gym Front, Oxana Gym Side 2, Oxana Gym Side, Oxana Office Front 2, Oxana Office Front, Oxana Office Side 2, Oxana Office Side, Oxana Sofa Front 2, Oxana Sofa Front, Oxana Sofa Side 2, Oxana Sofa Side, Oxana Yoga Front 2, Oxana Yoga Front, Oxana Yoga Side 2, Oxana Yoga Side, Patrizio Business Training Front, Patrizio Business Training Side, Patrizio Office Front, Patrizio Office Side 2, Patrizio Office Side, Patrizio Sofa Front, Patrizio Sofa Side, Piper Business Sofa Front, Piper Business Sofa Side, Piper Education Front, Piper Education Side, Rasmus Lounge Front 2, Rasmus Lounge Front, Rasmus Lounge Side 2, Rasmus Lounge Side, Rasmus Sofa Front 2, Rasmus Sofa Front, Rasmus Sofa Side 2, Rasmus Sofa Side, Raul Business Sofa Front 2, Raul Business Sofa Front, Raul Business Sofa Side 2, Raul Business Sofa Side, Raul Casual Sofa Front 2, Raul Casual Sofa Front, Raul Casual Sofa Side 2, Raul Casual Sofa Side, Raul Casual Sofa no iPad Front, Raul Casual Sofa no iPad Side, Raul Casual Sofa with iPad Front, Raul Casual Sofa with iPad Side, Raul Office Front 2, Raul Office Front, Raul Office Side, Raul Sofa Front 2, Raul Sofa Front, Raul Sofa Side 2, Raul Sofa Side, Ren Office Front 2, Ren Office Front, Ren Office Side 2, Ren Office Side, Ren Sofa Business Front, Ren Sofa Business Side, Ren Sofa Casual Front 2, Ren Sofa Casual Front, Ren Sofa Casual Side 2 , Ren Sofa Casual Side, Riley Casual Front, Riley Casual Side, Riley Office Front, Riley Office Side, Roman Outdoor Sport Front, Roman Outdoor Sport Side, Sabine Office Front 2, Sabine Office Front, Sabine Office Side, Sabine Sofa Side, Santa Fireplace Front, Santa Fireplace Side, Scarlett Couch Front 2, Scarlett Couch Front, Scarlett Couch Side 2, Scarlett Couch Side, Scarlett Fireplace Front, Scarlett Fireplace Side, Scarlett Hall Front, Scarlett Hall Side, Scarlett Yoga Front, Scarlett Yoga Side, Shawn Therapist, Silas Customer Support, Silas HR, Silas Lounge Front, Silas Lounge Side, Silas Sofa Side 2, Silas Sofa Side, Teodor Office Front 2, Teodor Office Front, Teodor Office Side 2, Teodor Office Side, Teodor Sofa Front 2, Teodor Sofa Front, Teodor Sofa Side 2, Teodor Sofa Side, Timothy Casual Front, Timothy Casual Side, Timothy Office Front, Timothy Office Side, Veit Office Front, Veit Office Side, Veit Sofa Front, Veit Sofa Side, Vernon Office Front 2, Vernon Office Front, Vernon Office Side 2, Vernon Office Side, Verena Office Front, Verena Office Side, Verena Sofa Front, Verena Sofa Side, Vernon Lounge Front 2, Vernon Lounge Side 2, Vernon Lounge Side, Vince Business Sofa Front, Vince Business Training Front, Vince Business Training Side 2, Vince Business Training Side, Vince Sofa Casual Front 2, Vince Sofa Casual Front, Vince Sofa Casual Side 2, Vince Sofa Casual Side, Matthew | Name of the Avatar V-eligible avatar to use. |
| audio | string | Yes | - | - | Optional audio file URL for the avatar to lip-sync to. When provided, prompt and voice are ignored. |
| fit | string | No | cover | cover, contain | How the avatar fits within the output frame. |
| remove_background | boolean | No | false | - | Remove the avatar background. Requires a matting-enabled avatar. |
| output_format | string | No | mp4 | mp4, webm | Output container format. WebM produces transparent video and ignores background. |
| resolution | string | No | 720p | 720p, 1080p, 4k | Output resolution preset. |
| aspect_ratio | string | No | 16:9 | 16:9, 9:16 | Aspect ratio of the output video. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |