HeyGen Avatar V Digital Twin
fal-ai/heygen/avatar5/digital-twinGenerate video from text and reference media with HeyGen Avatar V Digital Twin from fal through one Spiral API key. Create natural HeyGen Avatar V digital twin videos from text or audio, with lip-sync, optional backgrounds, captions, and MP4/WebM output. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
Up to $0.65 per run at the default inputs.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 1 hour
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
avatar | text | Abigail Sofa Front | Name of the Avatar V-eligible avatar to use. |
prompt | text | — | Text the avatar will speak. Required when ` |
voice | one of Warm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney, Patrick, David Castlemore, Michael C, Adam Stone , Juniper, Cassidy , Jessica Anne Bogart, Arabella, Andrew, Spuds Oxley , Grace Elder, Helen, Canyon Rivers, Derya - Lifelike - Excited 🤩, Mellow Marcus, Jack Sterling - Broadcaster 🎙️, Brenda - UGC - 1.mp4, Reid, Reagan, Terry, Jenny, Radio Rick, Denise, Tim in car - Excited 🤩, Iskander, Thompson, Delicate Daisy - Excited 🤩, Kingston, George UGC 1, Bold Blake, Jane, Expressive Evan, Marianne - IA, Aaron, Modern Recipe Host - Voice 1, Willow, Cute Chloe - Friendly 😊, Rafael, June - Lifelike, Crisp Chloe, Slick Simon, Nassim - Informative, Baritone Ben, Maxwell, Ellie Faye - Excited 🤩, Milani, Feisty Fiona - Excited 🤩, Professor Dean, Rose - UGC - 1.mp4, Shona, Hudson Wilder, Ann - IA, Alastair Kensington, Oxley, Christina, Andrew Rizz , Peyton, Gerardo - Outdoor, Chloe - Lifelike, Stephanie, Anthony - IA, Signal - Voice 1, Luca, Lisa - Voice 1, T.W.Tucker, Jack Sullivan - Serious 😐, Winter, Mireia - Lifelike, Georgia, Stella, Masha - Lifelike, Charming Charles - Friendly 😊, Serenity, Annie - Excited, Ralph, Bethany, Dominic, Mason Finn, Leena, Veteran Victor, Tamara, Nik Public, Calm Chloe, Sevik, Reilly, Raul, Imposing Ian, Relaxed Ray, Dexter - Professional, Relaxed Rick, Edwin, Rupert Blackwood, Ginny, Hope | Warm Pro Narrator | Name of the text-to-speech voice to use for the avatar when ` |
audio_url | URL or file | — | HTTP(S) URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech and ` |
fit | one of contain, cover | cover | How the avatar fits within the output frame. 'contain' keeps the full avatar in view (may letterbox); 'cover' fills the frame (may crop). |
remove_background | true or false | false | Remove the avatar's background. Requires a matting-enabled avatar. |
background | JSON | — | Optional background to composite behind the avatar. Ignored when ` |
watermark | JSON | — | Optional watermark image to overlay on the output video. |
caption | true or false | false | Generate a sidecar SRT caption file alongside the video. |
output_format | one of mp4, webm | mp4 | Output container format. 'webm' produces a transparent video (automatically removes the background) and ignores the ` |
resolution | one of 720p, 1080p, 4k | 720p | Output resolution preset. |
aspect_ratio | one of 16:9, 9:16, 4:5, 5:4, 1:1, auto | 16:9 | Aspect ratio of the output video. Supported values: '16:9', '9:16', '4:5', '5:4', '1:1', and 'auto'. 'auto' preserves the source aspect ratio when HeyGen can read it, falling back to '16:9' otherwise. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "fal-ai/heygen/avatar5/digital-twin",
"input": {
"prompt": "Hello and welcome to this demonstration of HeyGen Avatar V."
}
}'Frequently asked questions
How much does HeyGen Avatar V Digital Twin cost?
Up to $0.65 per run at the default inputs. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use HeyGen Avatar V Digital Twin through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/heygen/avatar5/digital-twin"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use HeyGen Avatar V Digital Twin?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use HeyGen Avatar V Digital Twin?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.