Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-05-17

HeyGen Avatar V Digital Twin

fal-ai/heygen/avatar5/digital-twin

Generate 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

FieldKindDefaultDescription
avatartextAbigail Sofa Front

Name of the Avatar V-eligible avatar to use.

prompttext—

Text the avatar will speak. Required when `audio_url` is not provided.

voiceone 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` is not provided.

audio_urlURL 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 `prompt/voice` are ignored.

fitone 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_backgroundtrue or falsefalse

Remove the avatar's background. Requires a matting-enabled avatar.

backgroundJSON—

Optional background to composite behind the avatar. Ignored when `output_format='webm'` (webm output is transparent).

watermarkJSON—

Optional watermark image to overlay on the output video.

captiontrue or falsefalse

Generate a sidecar SRT caption file alongside the video.

output_formatone of
mp4, webm
mp4

Output container format. 'webm' produces a transparent video (automatically removes the background) and ignores the `background` field.

resolutionone of
720p, 1080p, 4k
720p

Output resolution preset.

aspect_ratioone 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.