# HeyGen Avatar IV Digital Twin

Generate and edit video with HeyGen Avatar IV Digital Twin from fal through one Spiral API key. Heygen Avatar 4 Digital Twin Model. 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-02-23
- Tool id: `fal` / `fal-ai/heygen/avatar4/digital-twin`
- Page: https://spiral.ai/tools/fal/fal-ai/heygen/avatar4/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 |
| --- | --- | --- | --- | --- |
| `character` (required) | JSON |  | — | Character configuration for the video |
| `voice` (required) | JSON |  | — | Voice configuration for the character |
| `audio_url` | URL or file |  | — | URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech. |
| `resolution` | one of | 360p, 480p, 540p, 720p, 1080p | 720p | Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p |
| `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/avatar4/digital-twin",
    "input": {
      "character": {
        "avatar": "Florin Business Sitting Side"
      },
      "voice": {}
    }
  }'
```

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

## Common questions

### HeyGen Avatar IV Digital Twin

**How much does HeyGen Avatar IV 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 IV Digital Twin through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/heygen/avatar4/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 IV Digital Twin?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use HeyGen Avatar IV Digital Twin?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

