# HeyGen Avatar V 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.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Released: 2026-05-17
- Tool id: `fal` / `fal-ai/heygen/avatar5/digital-twin`
- Page: https://spiral.ai/tools/fal/fal-ai/heygen/avatar5/digital-twin

## Pricing

Up to $0.65 per run at the default inputs.

## Limits

- 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 | Allowed | 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 ``audio_url`` is not provided. |
| `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`` is not provided. |
| `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 ``prompt``/``voice`` are ignored. |
| `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 ``output_format='webm'`` (webm output is transparent). |
| `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 ``background`` field. |
| `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. |

## Example

```bash
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": {
      "avatar": "Abigail Sofa Front"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fheygen%2Favatar5%2Fdigital-twin

## Common questions

### HeyGen Avatar V Digital Twin

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

